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CHAPTER 1 


APAL 


1.1 INTRODUCTION 

Array Processor Assembly Language (APAL) is an unconventional assembly 

language and poses certain difficulties to programmers. In particular, 
the capability of the AP to process several instructions simultaneously 
needs attention. 

APAL code is compiled on the host system for execution on the array 


processor. APAL requires about 24K of memory on typical 1l6=bit 
mini~computers. 


1.2 BASIC SYNTAX 


This section presents the grammar of APAL. 


1.2.1 CHARACTER SET 
APAL recognizes the following characters: 


alphabetic A through Z 
numeric 0 through 9 


APAL recognizes also the special characters in Table l-l. 
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SPECIAL FUNCTION 


+ integer addition operator: unary addition operator 


- integer subtraction operator: unary subtraction operator 


integer multiplication operator 


/ inteser. division operator 
. decimal points current location 
$ first character of Pseudo-op names 
space symbol terminator 
tab symbo! terminator 


$EQU pseudo-op; DB = op-code; arithmetic identity 


( preceeds a data pad index expression 

) terminates a data pad index expression 

‘ used with DPX, DPY, and MI op-codes; arithmetic less than 
3 op-cede terminator 

2 opercnd separator 


: label terminator 


id comment start indicator (carriage return terminates) 
# s-pad no-load indicator 

& s-pad bit-reverse indicator 

! first character of predefined symbols 

% logical OR operator 

: logical compienent 

> arithmetic greater than 

? no ayeten function 

“ no system function 


Table l-l Special Characters 
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1.2.2 FILE NAMES 


File names may contain 30 characters, including special characters and 
numbers. On systems where programmed file assignment is not allowed or 
is very difficult, the user must enter the number of the logical unit 
of a file he assigned prior to calling APAL. 


A special symbol (which is different for each host system) exists for 
referencing the user terminal (for example: TT: for the PDPI11). 


Examples: 


RUNNER 
RUNNER .OBJ 
P38 
CHANNEL 


1.2.3 SYMBOL NAMES 


Symbol names may be of any length; however, only the first six 
characters of a name are significant. The first character of a name 
must be alphabetic. The subsequent characters may be either alphabetic 


or numeric. 
Examples: 


LOOP 
A6 
STARTHERE 


A symbol can be created and given a value by: 
e ‘defining it with the SEQU pseudo-op 


e using as a label 
® declaring it an external with the SEXT pséudo-op 
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1.2.4 TABLE MEMORY SYMBOLS 


A symbol with a value preset to the address of each of the constants in 


table memory ROM is predefined in APAL. 
to avoid conflict with any user-defined symbol. They 


the character ! 


These symbols all start with 


may be used in expressions in the same manner as ordinary symbols. 


A complete list of these symbols can be found in section 6.14. For 
example, the following fetches PI from table memory and adds it to a 


number in DPX(2). 


LDTMA; DB=!PI 
NOP 
FADD TM, DPX(2) 


1.2.5 INTEGERS 


Integers can be written in four radixes: 
In each radix, an integer can be either signed or 
The radix of a number is established by a radix identifying 


hexadecimal. 
unsigned. 


character which is written immediately after the number. 


"Fetch PI from T™ 
"Wait 
"Add PI to DPX(2) 


octal, binary, decimal, or 


Octal 


integers are denoted by a K, decimal by a ., hexadecimal by an X, and 


binary by aT. 
decimal digit. 


The first digit of a hexadecimal integer must be a 
The default radix, if a radix identifier is not user, 


is octal unless otherwise specified by a SRADIX pseudo-op. 


Integers are stores as 16=bit two’s complement numbers. 
larger than 16 bits are truncated to 16 bits. 


Integers 
Negative integers larger 


than 16 bits are truncated before they are negated. 


Examples: 


octal integers: 


decimal integers: 


hexadecimal integers: 


binary integers: 
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177777 
~40727K 
~10 


32767. 
+10. 


OABCDX 
123FX 
OCx 


101101T 
-1101T 


1.2.6 EXPRESSIONS 


Expressions are symbolic representations of numbers. They are made of 
Operands and operators. 


1.2.-60l Operands 


Operands are symbol names, numbers or the location counter (denoted by 


oe). 


Examples: 


TBLADR 
598X 


33K 
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lo 2u Oe Operators 


Operators are of two types: unary and binary. 


Unary Operators 


eo 


logical complement 
+ positive reminder (+3K,+10.) 
- gives negative of a number (-15X,-777) 


Binary Operators 


Standard Arithmetic operators 


+ addition 

- subtraction 

* multiplication 
/ division 


standard arithmetic relations, which return a value of one if the 
relation is true, and zero if the relation is false. For example, B 
SEQU 6<10 sets B to l 


< less than 
= equals 
> greater than 


Some expressions are: 


TBLADR+3F 

o + 9. 

LOOP +6 * A 
(34 = 10X) * 2 


Expressions are evaluated left to right in l6<bit two’s complement 
arithmetic according to FORTRAN precedence standards and parenthesis 
may be used liberally. | 


NOTE 


Only the low order 16 bits are used if an 
expression results in a value larger than 65535. 
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1.3 SOURCE PROGRAM STATEMENTS 


APAL source statements may be divided into three categories: 


e comment statements 
e instruction statements 
@e pseudo-op statements 


Comment statements allow program documentation. Instruction statements 
make up the actual symbolic machine code. Pseudo-ops provide 
directives to APAL during the assembly process. 


APAL statements are free format; spaces and tabs may be used as 
desired to improve legibility. 


1.3.1 COMMENT STATEMENTS 


Everything on a line following a quote mark (") is treated as a comment 
by APAL. A line which contains only comments, or a line that is 
completely blank, is a comment statement and is ignored during the 
assembly process. A carriage return terminates a comment. 
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1.3.2 INSTRUCTION STATEMENTS 


An APAL assembly language instruction statement has the format: 


label: Op-code fields "Comments 


The label and comments are optional. The assembler processes the 
op-code fields and generates one 64=—bit instruction word for each 
instruction statement. 


1.3.2.1 Label Field 


A label is a user-defined symbol which is assigned the value of the 
current location counter and entered into the user symbol table. A 
label is a symbolic means of referring to a specific location within a 
program. If present, a label always occurs first in an instruction 
statement and must be terminated by a colon. For example, assume the 
following instruction statement is entered. 


LOOP: FADD DPX, DPY "LOOP HERE 


If the current location is 76, value of 76 is assigned to symbol LOOP. 
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1.3.2.2 Op=code Field (Operation Code Field) 


The op=-code field follows the label field in an instruction statement 
and contains one or more AP op=code mnemonics-e Individual op-codes in 
an instruction are separated by a semi-colon. For example, the 
following two groups of op-codes are equivalent. The absence of a 
semi-colon following an op-code terminates the instruction. 


LOOP: FADD DPX, DPY; FMUL TM, MD; BFGT DONE 
or 
LOOP: FADD DPX, DPY; 
FMUL TM, MD; 
BFGT DONE 


Each is one instruction statement, which assembles into one 64-bit 
instruction word. Thus, one instruction statement may be continued 
over as many lines as desired to achieve a readable program document. 
The absence of semi-colon after the last op=-code signals the assembler 
that the instruction is ended. 


Op-codes may be written in any order within an instruction. The 
assembler flags any conflicting op-codes with an error message. 


Some op=-codes require operands as arguments. The operand is separated 
from the op=-code by a space or tab and from another operand by a comma. 
Some example op=codes are: 


no operands: HALT; RETURN 
one operand: FABS MD; BFGT LOOP 
two operands: FADD DPX, DPY; FMUL TM, MD 


If an operand is missing or improper, the assembler generates an 
appropriate error message. 


A list of all AP op-codes is contained in Section 1.6. 
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le3eze3 Comment Field 


The remainder of any line following a quote mark (") is treated as a 
comment by the assembler and is ignored- The comment field is 
terminated by a carriage return. Thus, the previous example can be 


written: 


LOOP: FADD DPS, DPY; "DO AN ADD 
FMUL TM, MD; "AND A MULTIPLY 
BFGT DONE "AND A BRANCH 


"ALL IN ONE INSTRUCTION 


An instruction is ended by the absence of a semi-colon following the 
last op-code. 
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1.3.3 PSEUDO-OPERATION STATEMENTS 


Pseudo-operations are directives to the assembler which control certain 
aspects of the assembly translation process. Each pseudo~-op must 
appear on a separate line in the source text. All pseudo-op names 
start with a "$". As with instruction statements, pseudo-op statements 
may be labeled and have comments. 


1.3.3.1 SEQU 


This operator equates a symbol with an expression. If user defined 
symbols are used in the expression, they must have been previously 
defined in the programe 


Examples: 


A SEQU 321 

LOOP SEQU LOC + 3 
HERE $EQU . - 3 
MASK SEQU 132%3+6 


Alternatively, the character "=" may be used in place of "SEQU": 
Examples: 


A =6 
X = A*3 
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1.3.3.2 SLOC 


SLOC sets the current location counter to the value of an expression. 
If symbols are used in the expression they must have been previously 


defined in the program. 


Examples: 


SLOC 300 
SLOC > +6 "LEAVE NEXT SIX UNUSED 
SLOC LOOP + 10 


NOTE 


SLOC should not be set to an absolute 
address, as in the first example, if the 
assembly output is to be linked relocatably 


with other programs. 


1.3.3.3 SEND 


SEND causes APAL to terminate the assembly. 


1.3.3.4 SVAL 


This operator defines 64 bits of data to fill one program word. The 
data must consist of four 16-bit integers or integer expressions which 
represent the four l6—bit quarters of a program word. The four 
expressions are separated by commas. 


Examples: 


SVAL =-377, 104763, 10., LOOP + 6 
SVAL 0, 0, 2000, 33 
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1.3.3.5 SFP 


This operator fills the right-most 38 bits of a program word with a 
specified floating point number. The left-most 26 bits of the word are 


cleared. 


Examples: 


SFP 6.0023E23 


SFP 2 
SFP E=17 
PIs SFP 32141592653 "PI 


A floating point number (for example, a constant for an algorithm) can 
be read out of program source memory and onto the data pad bus using a 
RPSF op=codee As an example, to load the contents of location PI into 


data pad &: 


RPSF PI; DPX<DB "GET PI INTO DPX 


1.3.3.6 STITLE 


This pseudo-op names a programe The name need not be unique among the 
other symbols in the program. The S$TITLE pseudo-op must occur as the 
first statement in a program. 


Examples: 


STITLE FFT 
STITLE DIVIDE 
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1.3.3.7 SENTRY 


This pseudo-op declares a symbol to be global, that is, a symbol which 
is defined in this program and may be referenced by other separately 
assembled programs.. The identified symbols must be defined in this 
program either by an SEQU pseudo-op or by their use as a label. SENTRY 
pseudo-ops must occur before any instruction statements in the program. 


If a symbol is to be an entry point for host computer FORTRAN calls, it 
must be the first entry symbol defined. Following the symbol name must 
be the number of s-pad parameters expected in the call. This may be a 
number from 0-173, and is separated from the symbol name by a comma. 


Examples: 


SENTRY A 
SENTRY B,6 "Expect 6 s-pad parameters 
SENTRY C,0 "Expect 0 s=pad parameters 


le 3. 3.8 SEXT 
This pseudo-op declares global symbols which are referenced by this 
program, but are defined by another separately assembled programe SEXT 


pseudo-ops must occur in the program before any instruction statements. 
Symbol names are separated by commas. 


Examples: 


SEXT FLOAT, SCALE, FFT 
SEXT DIVIDE 
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1.3.3.9 SINSERT 


This pseudo-op causes source to be read from the designated file. The 
line number is reset. When end-of-file is encauntered source is again 
read from the file originally specified in the APAL call. The line 
count is set to its original value when the end of the SINSERT file is 
reached. Also, when the SINSERT file is reached during Pass 1 of 
assembly the line containing the $INSERT is written to the terminal. 
When its end is reached, the message "END $INSERT" is written in the 
listing. (This happens during Pass 2, also.) 


Example: 


SINSERT  FILEA 


1.3.3.10 SRADIX 
SRADIX changes the default number radix to the value of the expression. 


It is entered and evaluated in base 10. It must be either 8, 10, or 
16. 


Example: 


SRADIX 10 
SRADIX 16 


1.3.3.11 SIF ...SENDIF 
This allows conditional assembly. If the expression which follows SIF 


evaluates to zero, any subsequent source lines up to SENDIF are not 
assembled. They do, however, appear on the listing. 


Examples: 


SIF PROG 
PROG SEQU 0 
SENDIF 
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1.3.3.12 SPAGE 


SPAGE begins a new page on the listing. 


l. 3. 3. 13 SBOX. ee SENDBOX 


All source lines found between $BOX and SENDBOX statements are 
considered comments and are surrounded by a box of asterisks when a 
listing is produced. They may be used to improve readability of the 
listing. 


1.3.3.14 SLIST and SNOLIST 


Source occurring after a SNOLIST does not appear on the listing file. 
The presence of a SLIST terminates this condition. Source occurring 
after a SLIST does appear on the listing file. If no listing was 
specified in the call to APAL, neither of these has any effect. 


1.3.3.15 SLIB...SENDLIB 


These two pseudo-ops cause loader library blocks and end library blocks 
to be written to the object file. APLINK treats an object module 
preceded by a library block as a library, and loads only those routines 
that satisfy unsatisfied externals. 


1.3.3.16 Dummy FMUL and FADD Pushers 


When programming pipelines as desribed in Part One of the Programmer’s 
Reference Manual, it is convenient for readability to include in the 
code all the FMULs and FADDs that are used as pushers in any of the 
columns of the handwritten pipelines. These are coded without 
parentheses. Any FMUL or FADD without arguments does not conflict with 
other arithmetic arguments of like type and is completely ignored 
unless it is the only op=-code of its type. 


Example: 
FADD DPX1, DPY1; FMUL FM,FA; FADD 


In this example the last FADD is ignored. 
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1.3.4 ORDER OF PROGRAM STATEMENTS 


There is a definite ordering of statement types within a program which 
must be followed. STITLE pseudo-op must appear first. Any SENTRY and 
SEXT pseudo-ops must follow. Then the program body, that is, the code, 
occurs. Finally the SEND pseudo-op occurs. Statement order is as 


follows: 


STITLE pseudo-op 
SENTRY pseudo~op(s) 
SEXT pseudo-op(s) 


“program, etc" 


SEND pseudo-op 


1.3.5 SAMPLE APAL PROGRAM 


Figure l-1 illustrates a sample APAL progran. 


$TITLE PROGL 
SENTRY PROGL,3 
SEXT DIV 


“PROGL DIVIDES TYO SCALARS IN MAIN DATA 
“AND RETURNS THE ANSWER TO MAIN DATA 
“MEMORY. C=A/B. 


“S-PAD PARAMETER DEFINITIONS: 


A $—Qu 0 "ADDRESS OF A IN MAIN DATA MEMORY 
B SEQU 1 “ADDRESS OF B IN MAIN DATA MEMORY 
C SEQU 2 “ADDRESS OF C IN MAIN DATA MEMORY 
PROG1: MOV A,A: SETMA “FETCH A 
MOV B.B: SETMA “FETCH B 
NOP “WAIT 
DPY< MD “STORE A IN DPY 
DPX< I'D: “STORE B IN DPX 
JSR DIV “AND DIVIDE A BY B 
MOV C.C: SETMA:; MI<DPX; "STORE ANSWER IN C 
RETURN “AND RETURN 
SEND 


Figure l-1 Sample APAL Program 
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1.4 OPERATING PROCEDURES 


This section describes the operation of APAL. 


1.4.1 USING APAL 


APAL assembles a file of source code into a relocatable object file. 
Optionally an assembly listing is produced. 


APAL first requests the names of the three files to be used for source, 


oject, and listing and errors respectively. The program requests the 
name of the source file by outputting to the user console: 


SOURCE FILE= 


The user responds by entering the desired program file name- APAL then 
requests the name of the file to receive the relocatable object module 
by outputting: 


OBJECT FILE= 


The user responds by entering the desired object file name- APAL then 
requests the name of the file to receive the assembly listing by 
outputting: 


LISTING AND ERROR FILE= 


The user replies by entering the name of the desired listing file. If 
APAL cannot find or assign the requested file it outputs the message 
“FILE NOT FOUND OR UNAVAILABLE" and repeats its request. 


APAL then outputs: 


LISTING? (Y/N) 
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A response of Y(cr) yields a full assembly listing, symbol table, and 
any error messagese An N(cr) suppresses the assembly and symbol table 
listings and writes any error messages to the listing file. 


Finally, if a listing was requested, APAL outputs: 


LISTING RADIX? (8,10,16) 


A response of "8" causes the assembly listing to be done in octal; a 
"10" specifies decimal; and a "16", hexadecimal. 


APAL responds to invalid input with ??? and repeats the request. 


The following is an example of a dialogue with APAL. The user desires 
to assemble an AP program on file FFT.AP and write the object output 
into file FFT.RB.- The listing is placed on file FFT.LS. Of course, 
the precise details of how files and devices are named depends on the 
particular operating system being used. The messages printed by the 
computer are underlined for clarity; the (cr) indicates a carriage 
return. 


APAL 

SOURCE FILE = 
FFT.AP (cr) 
OBJECT FILE = 
FFT.RB (cr) 
LISTING FILE = 
FFT.LS 
LISTING? 

Y(cr) 

LISTING RADIX? 
8(cr) 
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1.4.2 EXECUTION 


If a fatal error occurs, the message "RUN ABORTED" is displayed at the 
terminal and control is returned to the operating system. 


1.4.3 LISTING FILE FORMAT 


APAL is a two-pass assembler. When APAL is called, it outputs: 


APAL 
(version) 


(version) is the version number of the assembler being used. Any 
errors detected during pass 1 are output next. The assembly listing 
(if requested) follows and is interspersed with pass 2 error messages. 
The listing contains the following information for each program 
Statement: 


first colum second colum third colum fourth column 
source program assembled source 
code source program statement 
line number address 

(location 

counter) 
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For program instruction statements, the assembled data is presented as 
four numbers representing bits 0-15, 16-31, 32-47 and 48-63 of each 
program source word. 


At the end of pass two, APAL outputs 


(num) ERROR(S) FOR (title) 


(num) is the number of errors detected and (title) is specified by the 
STITLE pseudo-op in the last routine assembled. Finally, APAL outputs: 


SYMBOL NAME 


Followed by the symbol table: 


first column second column third colum 
symbol symbol symbol 
name value type 


blank = local symbol 
EXT =- external symbol 
ENT - entry symbol 


In all of the above occurrences where a number (location, data value, 
etc-) is printed on the listing, the radix is either octal, decimal or 
hexadecimal, as specified by the user during the initial dialogue. 
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1.4.4 SAMPLE APAL LISTING 


Figure 1-2 contains a sample APAL listing. 


APAL REV 2.1 PROG1 03/13/78 11:49 
PAGE 0001 
PASS1 
PASS2 
00001 $STITLE PROG1 
00002 SENTRY PROG1,3 
00003 $EXT DIV 
00004 
00005 "PROG] DIVIDES TWO SCALARS IN MAIN DATA 
00006 “AND RETURNS THE ANSWER TO MAIN DATA 
00007 “MEMORY. C=A/B. 
00008 . 
00003 “S-PAD PARAMETER DEFINITIONS: 
00010 m 
00011 000000 A $EQU 0 “ADDRESS OF A IN MAIN DATA MEMORY 
00012 000001 B $EQU 1 “ADDRESS OF B IN MAIN DATA MEMORY 
00013 000002 C $EQU 2 “ADDRESS OF C IN MAIN DATA MEMORY 
00014 a 
00015 00000 O40000 “PROGL: MOV A.A; SETMA “FETCH A 
000000 
000000 
000060 
00016 000001 040104 MOV BsBs SETMA “FETCH B 
000000 
000000 
000060 
00017 000002 000000 NOP “WAIT 
000000 
000000 
000000 
-00018 000003 000000 DPY< *D “STORE A IN DPY 
000000 
015000 


1600000 


Figure 1-2 Sample APAL Listing 
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00019 000004 011014 DPX< MD; "STORE B IN DPX 
00020 000000 JSR DIV “AND DIVIDE A BY B 
045004 
177777 


00021 000005 040210 MOV C.C; SETMA; MI< DPX “STORE ANSWER IN C 
000000 
003400 
003600 


06022 000006 000000 RETURN "AND RETURN 
000340 . 
000000 
relereyerere) 


00023 SEND 
Q000 ERROR (S) FOR PROG1.. : 


SYMBOL VALUE 


DIV 000000 EXT 
A 000000 
B 090001 
C 000002 
PROGL 000000 ENT 


Figure 1-2 Sample APAL Listing (cont.) 
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1.5 ERROR MESSAGES 


APAL error messages are printed in the listing following the illegal 
Statement. 


There are five basic error classes, which are listed in the following 
along with the action taken by the assembler: 


O - Out of range: an illegal numeric value was truncated to 
the proper range 


Q 
( 


Conflicting definitions: the first definition was used 
M - Missing (or improper) argument: a value of zero was used 
B - Bad syntax: the bad op-code field or pseudo-op was ignored 


W - Warning of improper usage 


The actual diagnostic takes the following form: 


***k c msg non ON LINE nnnnn 


where c is the error class, msg is the error message, nn is the error 
number, and nnnnn is the number of the erroneous line. The assembler 
error messages, along with an explanation as to the possible causes 
and/or cures, are given in Table 1-2. 
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Table l=-2 Error Messages 


Error Cate- 
No, gory Message Explanation 

1 W LINE BUFFER OVERFLOW An instruction statement was too long 
(690 characters maximum) for the listina 
buffer, 

2 C MULTIPLY DEFINED SYMBOL 4 symbol may be defined only once ina 
program. 

3 C CONFLICTING OP-CODES Two op-codes were used in an tnstruction 


statement which used the same instruction 
word bit fields. 


4 W S-PAD ADDRESS TRUNCATED An s-pad address was outside the legal 
range of 0-15 and was truncated to 4 bits. 


5 0 BRANCH 4DDRESS QUT OF RANGE A branch address was more than 16 loca- 
tions lower or 15 locations hisher than 
the current location. 


5 . CONFLICTING BRANCH ADDRESSES Only one branch address may be used in 
any given instruction statement. 


8 & CONFLICTING DATA PAD INDEXES Only one value may be given to each dcta 
pad index (XR, XW. YR. YW) per instruc- 
tion statement. 


oe BAD OR MISSING EXPRESSION The assembler could not process an ex- 
pression. 

10 M BAD OR MISSING FADD ARGUMENT A floating adder op-code had an invalid 
Al or A2 operand. 

11 4 A WRONG FMUL ARGUMENT A FMUL op-code had an invalid M1 or M2 
operand. 

13 ¢ VALUE FIELD CONFLICT Only one op-code which uses a l6-bit 


VALUE field operand may be used per 
instruction statement. 


15 B UNDEFINED OP-CODE An om-code name was not a legal AP 
instruction. 
16 M EXTERNAL SYMBOL IN EXPRESSION An external symbol may not be used to 


form an expression. 


17 M UNDEFINED USER SYMBOL A user symbol! was referenced which was 
not defined. 


29 B UNRECOGNIZED STATEMENT A statement line was neither a comment. 
instruction, or pseudo-op statement. 


0434 
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Table 1-2 Error Messages (cont.) 


Error cate- 


No. Gory Messaje Explanation 
22 M EXTERNAL SYMBOL NOT ALLOWED An external symbol may not be used as 
an argument for this op-code.. 
23 W MISSING $END A progrom must terminate with a $END 
pseudo-op. 
24 0 DATA PAD INDEX OUT OF RANGE A data pad Index must be between -4 


and +3 inclusive. 


31 M BAD FLOATING POINT CONSTANT A floating-point number was unaccept- 
able to the assembler. 


32 W ILLEGAL PSEUDO-OP POSITION If used, A $TITLE pseudo-op must appear 
first in a program, followed by any 
SEXT or SENTRY pseudo-ops. 


34 W UNREFERENCED $EXT SYMBOL - A declared external symbol was never 
used in the program. Tne symbol cppears 
in the sympol table labeled EXT with 
the value of 177777 (octal). 


36 £ DATA PAD BUS CONFLICT Only one datc source may be enabled 


onto the data pad bus per instruction 
statement. 
37 M MISSING S-PAD ARGUMENT An s-pad op-code was missing its s-pad 


register address. 


39 C XW/YW CONFLICT If the value field is used in an 
instruction, an op-code which writes 
into data pad Y (such as DPY(2)<FM) 
may be used also only if 
@ no write into data pad X ts done, or 
@ the indexes are the same for the 
writes into both DPX and DPY. 


examples: 
legal: JSR SORT; uses the value 
DPY(2)<FM field and a store 
into DPY. 


legal: JSR SQRT; Uses the value 
DPX(2)<FA field and both 
DPY(2)<FM data pad write 
indexes are the 
some. 


illegal: JSR SQRT,; Uses the value 
DPX(-1)<FA; field and the two 
DPY(2)<FM data pad write 
indexes are dif- 
ferent. 


0495 
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Table 1-2 Error Messages (cont.-) 


a oer) Message Explanation 

43 READ ERROR There was a file 1/0 error. 

Uy 0 SYMBOL TABLE OVERFLOW Too many user symbols. 

45 B BAD OR MISSING SYMBCL STRING A symbol was missing or tllegal. 

46 0 EXPRESSION STACK OVERFLOW Too many parenthesis in an expression. 

47 B BAD SENTRY Incorrect $entry statement or the sentry 
symbol was also found in a $EXT. 

4g OB BAD $VAL Incorrect $VAL statement. 

49 W BAD $TITLE Incorrect cyntax in a $TITLE statement. 

50 W EXTRANEQUS BRCUHAHA Extraneous characters were found with 
an opcode. 

51 W BAD OR MISSING DELINITER DPX- (3) Incorrect punctuation. 


52 M BAD OR MISSING DATA PAD (BUS) ARG A data pad argument is missing or 


incorrect. 
53 B UNRECOGNIZED PSEUDO-OP An illegal pseudo-op was encountered. 
54 FILE NOT FOUND OR NST AVSILABLE The specified file was not found or 

is not available 
55 B NESTED PSUEDO-OP NOT ALLOWED The specified pseudo”op cannot be nested. 
56 W $ENDBOX WITHOUT $BOX A $BOX must occur before an $SENDBOX. 
57 W DIVISION BY ZERO Result is 65,535, 
59 W MULTIPLE LABELS Attempt to put more than one label 

on a line. 

0496 
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1.6 AP SYMBOLIC CODES 


The various AP op-codes may be divided into 13 groups. One op-code 
from each group may be used in any given instruction statement, unless 
otherwise stated. 


The following conventions are used throughout this chapter: 


{ } Indicates optional operands or mnemonics. The item enclosed in 
the brackets (for example, {#}) may or may not be entered, 
depending upon whether or not the associated option is 


desired. 


Under the headings "Function" and "Meaning," upper case characters are 
used to indicate the origin of the mnemonic code names. 


The list of abbreviations contained in Table 1-3 are used to facilitate 
the op=-code descriptions. They are explained later when the op~code 
group first appears. 
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Table 1=3 Op-code Abbreviations 


Section in 
Abbreviation Meaning which described 
sh s-dad shift B-1 
# s-pad no-load B-1 
sps S-pag source register B-1 
spd s-pad destination register B-1 
& bit reverse B-1 
disp branch displacement B-5 
ob floating adder argument #1 B-6 
a2 Floating adder argument #2 B-6 
idx data pad index B-6 
m1 floating multiplier argument #1 B-7 
m2 Floating aaitisiner argument #2 B-7 
dbe data pad bus enable B-8 
adr address or value B-8 


0497 
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1.6.1 S-PAD OP-CODE GROUP 


Purpose: s=pad integer arithmetic 


Double Operand Op-codes 


ADD{sh}{#}{&}sps,spd 
SUB{sh}{#}{&}sps,spd 
MOV{sh }{#}{&}sps,spd 
AND {sh }{#}{&}sps,spd 
OR{sh}{#}{&}sps,spd 

EQV{sh }{#}{&}sps,spd 


Single Operand Op=-codes 


CLR{sh}{#} spd 
INC{sh }{#} spd 
DEC {sh}{#} spd 
COM{sh}{#} spd 


Function 


ADD sps to spd 
SUBtract sps from spd 
MOVe sps tp spd 

AND sps tp spd 

OR sps to spd 
EQuiValence sps to spd 


Function 


Clear spd 
INCrement spd 
DECrement spd 
COMplement spd 


The result of the above op=<codes is SPFN (s=-pad function). 


Miscellaneous Op-Codes 


LDS PNL 
LDSPE 
LDSPI 
LDSPT 
WRTEXP 
WRTHMN 


WRTLMN 
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Function 


LoaD Spd from PaNeL bus 

LoaD SPd from data pad bus Exponent 

LoaD SPd from data pad bus Integer 
(low 16=bit) 

LoaD SPd from data pad bus Table 
look-up bits . 

enable WRiTe of EXPonent only into 
DPX, DPY or MI 


‘enable WRiTe of High MaNtissa only 


into DPX, DPY or MI 
enable WRiTe of Low MaNtissa only 
into DPX, DPY or MI 


Abbreviations: 


Name Meaning 


sh s-pad shift: 
Choices Meaning 
(omitted) no shift 
L shift SPFN left once 
R shift SPFN right once 
RR shift SPFN right twice 
# s-pad no-load: if present, do not load SPFN into spd (s-pad 


destination register). If specified, a branch group op-code 
May not be used in the same instruction statement. 


sps s-pad source register: a name, number, or expression 
specifying a register number between 0 and 17g. 


spd s-pad destination register: a name, number, or expression 
specifying a register number between 0 and 17g. 
SPFN is loaded into the s-pad destination register unless 
s-pad no-load (#) is specified. 


& Bit reverse: if present, bit reverse the contents of sps 
before using. The bit reverse is done as specified by 
bits 13-15 of the internal status register. 


Examples: 


MOV 3,6 

SUBL 1,15 

ADDL# &PTR, BASE 
DEC CTR 

CLR 9. 

LDSPI 6 
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1.6.2 MEMORY ADDRESS OP-CODE GROUP 


Purpose: initiate main data memory cycles 


Op-codes Function 

INCMA INCrement Memory Address 
DECMA DECrement Memory Address 
SETMA SET Memory Address from SPFN 


1.6.3 TABLE MEMORY ADDRESS OP=-CODE GROUP 


Purpose: initiate table memory fetches 


Op-codes Function 

INCTMA INCrement Table Memory Address 
DECTMA DECrement Table Memory Address 
SETTMA SET Table Memory Address from SPFN 


1.6.4 DATA PAD ADDRESS OP-CODE GROUP 


Purpose: change the DPA (data pad address) register 


Op-codes Function 

INCDPA INCrement data pad Address 
DECDPA DECrement data pad Address 
SETDPA SET data pad Address from SPFN 
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1.6.5 BRANCH OP=CODE GROUP 


Purpose: 


Examples: 


conditional branches 


Op-code 
BR disp 
BINTRQ disp 
BION disp 
BIOZ disp 
BFPE disp 
BFEQ disp 
BFNE disp 
BFGE disp 
BFGT disp 
BEQ disp 
BNE disp 
BGE disp 
BGT disp 
RETURN 
Abbreviation: 
disp 


Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 
Branch 


RETURN 


Function 


unconditionally 
INTerrupt ReQuest flag non-zero 


on 
if 
Lf 
on 
on 
on 
on 
on 
on 
on 
on 
on 


I/O data ready 
I/O data ready 
Floating Point 
Floating adder 
Floating adder 
Floating adder 
Floating adder 
s-pad function 
s~pad function 
s-pad function 
s~-pad function 


from subroutine 


flag Non-zero 

flag Zero 

Error 

EQual to zero 

Not Equal to zero 
Greater or Equal to zero 
Greater than zero 

EQual to zero 

Not Equal to zero 
Greater or Equal to zero 
Greater than zero 


branch displacement: The branch target address, an 
address between 16 locations behind and 15 locations 
ahead of the current location. 


BR LOOP 
BGT .+3 
BFNE A-~4 
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1.6.6 FLOATING ADDER OP-CODE GROUP 


Purpose: floating-point adds 


Double Operand Op=codes 


Op-codes 

FADD al,a2 
FSUB al,a2 
FSUBR al,a2 
FAND al,a2 
FOR al,a2 
FEQV al,a2 


Function 


Floating ADD (al+a2) 

Floating SUBtract (al-a2) 
Floating SUBtract Reverse (a2-al) 
Floating AND (al and a2) 
Floating OR (al or a2) 

Floating EQuiValence (al eqv a2) 


Single Operand Op-codes 


Op-codes 

FIX a2 
FIXT a2 
FSCALE a2 
FSCLT a2 
FSM2C a2 
F2CSM a2 
FABS a2 


Adder Operands: 


Function 


FIX a2 to an integer 

FIX a2 to an integer (Truncated) 

Floating SCALE of a2 

Floating SCALE of a2, (Truncated) . 

Format conversion, Signed Magnitude to 2°s complement 
Format conversion, 2°s complement to signed magnitude 
Floating ABSolute value 


operand Meaning 


al floating adder argument no. 1: 
Choices Meaning 
NC No Change (use previous al) 


FM Floating Multiplier output 
DPX { (idx) } Data Pad X 

DPY { (idx) } Data Pad Y 

™ Table Memory data 

ZERO floating-point ZERO 
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Operand Meaning 


a2 adder argument noe 2: 

Choices Meaning 

NC No Change (use previous a2) 

FA Floating Adder output 

DPX { (idx) } Data Pad X 

DPY { (idx) } Data Pad Y 

™ Table Memory data 

ZERO floating ZERO 

MDPX { (idx) } use Mantissa from data pad X, 
and exponent from SPFN 

EDPX { (idx) } use Exponent data pad X, and 


mantissa from SPFN 


Abbreviation: 
Name Meaning 
idx data pad index: a name, expression, or number which 


lies in a range of -4 to +3. 


Examples: 


FADD TM,MD 

FSUB DPX(3), DPY(-4) 
FEQV DPX, DPY(C) 
FAND ZERO, MDPX(2) 
FSUBR NC,FA 

FADD 


NOTE 


Up to four unique data pad indices may be 
specified in one instruction statement. In 
particular, only one indexing each may be 
used for reading from data pad X and Y, re~ 
gardless of how many op-codes use the data 
read from data pad. 
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1.6.7 FLOATING POINT MULTIPLY OP-CODE GROUP 


Purpose: floating point multiplies 


Op-code Function 


FMUL ml,m2 Floating MULtiply ml times m2 


Multiplier Operands: 


Operand Meaning 
ml Multiplier-operand no. l 
Choices : Meaning 
FM Floating Multiplier output 
DPX{ (idx) } data pad X 
DPY{ (idx) } data pad Y 
™ Table Memory 
m2 Multiplier-operand noe 2 
Choices Meaning 
FA Floating Adder output 
DPX{ (idx) } data pad X 
DPY{ (idx) } data pad Y 
MD Memory Data 
Examples: 
-FMUL TM, MD 
FMUL DPX (AR),DPY (BIL) 
FMUL 
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1.6.8 DATA PAD X OP=CODE GROUP 


Purpose: storing into data pad X 


Op-code Function 


DPX{ (idx) }<opt Store opt into Data Pad 


X- One of the following must be 


used for opt. 


Opt Meaning 


FA Floating Adder Output 
FM Floating Multiplier outut 


DB Data pad Bus 


dbe Data Pad bus Enable 
This has the same effect 
as an explicit data pad bus 
op-code.e. One choice of 
data pad bus enable may 
be made per instruction 


statement. 


Choices 
ZERO 


adr 


DPX{ (idx) } 
DPY{ (idx) } 
MD 

DPFN 

T™ 
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Meaning 
floating ZERO 


An address or 
numeric value» 

any l6=bit integer 
expression is 
legal. A floating 
multiplier, memory 
input, memory 
address or data 
pad address 
op-code can not 

be used in an 
instruction 
statement where 
an “adr" is 

usede 


Data Pad X 

Data Pad Y 
Memory. Data 

s~pad Function 
Table Memory data 


Examples: 


DPX(3)<IM 

DPX (-2)<SPFN 
DPX MD 
DPX(1)<DPY (<2) 
DPX(=2)< =123 


1.6.9 DATA PAD Y OP=-CODE GROUP 


Purpose: storing into data pad Y 


Op-code Function 


DPY{ (idx) }<opt Store opt into data pad 
Y. The possibilities for opt are 


the same as those described in Section 
1.6.8. 


Examples: 


DPY (-2)<FA 
DPY<MD 

DPY (2) <TM 

DPY (1)<39 
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1.6.10 MEMORY INPUT OP-CODE GROUP 


Purpose: writing into main data memory 


Op-codes Function 

MI<FA Move Floating Adder output to the Memory Input 
register 

MI<FM Move Floating Multiplier output to the Memory Input 
register 

MI<DB Move data pad Bus to the Memory Input Register 

MI<dbe Move dbe to the Memory Input Register 


To effect a memory write, an op-code from the memory address group or 
an LDMA op=-code must be included in the instruction statement to supply 
the memory address. 


Examples: 


MI<FA; INCMA 
MI<DPX(3); DECMA 
MI<MD; SETMA; ADD 3,6 
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1.6.11 DATA PAD BUS OP=CODE GROUP 


Purpose: explicitly enable data onto the data pad bus 


Op-codes Function 

DB=ZERO enable ZERO onto the data pad bus 

DB=adr enable adr onto the data pad bus 

DB=DPX{ (idx) } enable Data Pad X onto the data pad bus 
DB=DPY{ (idx) } enable Data Pad Y onto the data pad bus 

DB=MD enable Memory Data onto the data pad bus 

DB=S PFN enable S=Pad Function onto the data pad bus 
DB=IM enable Table Memory data onto the data pad bus 


As mentioned earlier, only one data source may be enabled onto the data 
pad bus per instruction statement. 


Examples: 


DB = 37 

DB = DPX(=2) 
DB = MD 

DB = SPFN 
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1.6.12 SPECIAL OPERATION OP=CODE GROUP 


If an op=-code from this group is chosen, an s=pad group op=code can not 
be used in the same instruction statement. 


1.6.12.1 Special Tests 


Purpose: additional conditional branches 


Op-codes Function 

BFLT disp Branch on Floating adder Less Than Zero 
BLT disp Branch on s=-pad function Less Than zero 
BNC disp Branch on Non=-zero Carry bit 

BZC disp Branch on Zero Carry bit 

BDBN disp Branch if Data pad Bus Negative 

BDBZ disp Branch if Data pad Bus Zero 

BIFN disp Branch if Inverse FFT flag Non zero 
BIFZ disp Branch if Inverse FFT flag Zero 

BFLO disp Branch if Flag 0 is l 

BFL1 disp Branch if Flag 1 is l 

BFL2 disp Branch if Flag 2 is l 

BFL3 disp Branch if Flag 3 is l 


If one of these tests is used along with a test from the branch group, 
the conditions are OR’d. In this case, only one of the branch opcodes 
need have the target address as an operand. 


Examples: 


BNC ODD 
BFEQ LOOP; BFLT LOOP "LESS THAN OR EQUAL TO 
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1.6.12.2 SETPSA 


| Purpose: jumps and subroutine jumps 


Op-codes Function 
JMP{A} adr JuMP to location adr 
JMPT JuMP to location whose address is in TMA 
JMPP JuMP to location whose address is on the Panel bus 
JSR{A} adr JumP to SubRoutine at location adr 
JSRT JumP to SubRoutine at address in Tma 
JSRP JumP to SubRoutine at address on Panel bus 
Examples: 
JMP LOOP + 3 
JSR FFT 
JMPS 300 


1.6.12.3 SETEXIT 


Purpose: alter a subroutine return 


Op-codes Function 
SETEX{A} adr SET subroutine EXit to adr 
SETEXT SET subroutine EXit to contents of Tma 
SETEXP SET subroutine EXit to contents of Panel bus 
Example: 
SETEX BAD 
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1.6.12.4 Program Source 


Purpose: read/write program source memory 


Op-codes 


RPSL{A} adr 
RPSF{A} adr 


RPSLT 
RPSFT 


RPSLP 
RPSFP 


Function 


Read Program Source Left half of location adr 
Read Program Source Floating-point number 
from location adr 
Read Program Source Left half at address in Tma 
Read program Source Floating point number 
at address in Tma 
Read Program Source Left half at address on Panel bus 
Read Program Source Floating-point number at address 
on Panel bus 


These op=codes read onto the data pad bus 


Op-codes 


LPSL{A} adr 
LPSR{A} adr 
LPSLT 
LPSRT 
LPSLP 
LPSRP 


Function 


Load Program Source Left half of location adr 

Load Program Source Right half of location adr 

Load Program Source Left half pointed at by Tma 

Load Program Source Right half pointed at by Tma 

Load Program Source Left half pointed at by Panel bus 
Load Program Source Right half pointed at by Panel bus 


These op=-codes load from the data pad bus. 


Example: 


RPSF PI 
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1.6.12.5 PS Odd and Even 


Purpose: reading the host panel switches into 
writing program source to the panel lites. 


program source memory, 


Op-codes Function 

RPSO{A} adr Read Program Source quarter 0 from location adr 
RPS1{A} adr Read Program Source quarter 1 from location adr 
RPS2{A} adr Read Program Source quarter 2 from location adr 
RPS3{A} adr Read Program Source quarter 3 from location adr 
RPSOT Read Program Source quarter 0 from address in Tma 
RPS IT Read Program Source quarter 1 from address in Tma 
RPS2T Read Program Source quarter 2 from address in Tma 
RPS3T Read Program Source quarter 3 from address in Tma 
WRSO{A} adr Write Program Source quarter 0 into location adr 
WPS1{A} adr Write Program Source quarter 1 into location adr 
WPS2{A} adr Write Program Source quarter 2 into location adr 
WPS3{A} adr Write Program Source quarter 3 into location adr 
WPSOT Write Program Source quarter 0 into address in Tma 
WPSIT Write Program Source quarter 1 into address in Tma 
WPS 2T Write Program Source quarter 2 into address in Tma 
WPS 3T Write Program Source quarter 3 into address in Tma 


1.6-12.6 Hostpanel 


Purpose: 


panel lites 


Op-codes 


PNLLIT 
DBELIT 
DBHLIT 
DBLLIT 
SWDB 
SWDBE 
SWDBH 
SWDBL 
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Function 


PaNel bus to 


Data 
Data 
Data 


SWitches 
SWitches 
SWitches 
SWitches 


Bus 
Bus 
Bus 


pad 
pad 
pad 


LiTes 


Exponent to LiTes 
High mantissa to LiTes 
Low mantissa to LIiTes 


i <= 


to Data pad Bus 
to Data pad Bus Exponent 
to Data pad Bus High mantissa 
to Data pad Bus Low mantissa 


44 


reading the host panel switches, writing to the host 


1.6.12.7 Miscellaneous 


Op-codes Function 
SPNDAV Spin until MD available 


1.6.13 I/O OP=CODE GROUP 


If an op-code is used from this group, a Floating Adder opcode can not 
be used in the same instruction statement. 


1.6.13.1 Load REG, Read REG 


Purpose: reading/writing various internal registers 


Op-codes Function 

LDSPD LoaD s=pad Destination address register 
LDMA LoaD Memory Address register 

LDTMA LoaD Table Memory Address register 
LDDPA LoaD Data Pad Address register 

LDSP LoaD s=-pad register pointed at by spd 
LDAPS LoaD AP Status register 

LDDA LoaD 1/0 Device Address 


The above op-codes load from the data pad bus. 


Op-codes Function 

RPSA Read Program Source Address 

RSPD Read s—pad Destination register 
RMA Read Memory Address register 

RTMA Read Table Memory Address register 
RDPA Read Data Pad Address register 

RS PFN Read s-pad Function 

RAPS Read AP Status 

RDA Read I/0 Device Address 


These opcodes read onto the panel bus. 
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1.6.13.2 INOUT 


Purpose: program contol/input output of data 


Op-codes Function 

OUT OUTput data 

SPNOUT SPiN until device ready, then OUTput data 
OUTDA OUTput data, then set DA to spfn 

SPOTDA SPin until device ready, OuTput data, then 


set DA to spfn 


The above write to the I/O device specified by the device address 
register (DA) whatever data is enabled onto the data pad bus. 


Op-codes Function 

IN INput data 

SPININ SPIN until device ready, then INput data 

INDA INput data, then set DA to spfn 

SPINDA SPin until device ready, the INput data, then 


set DA to spfn 


These instructions put data onto the input bus from the 1/0 device 
specified by the device address register (DA). To be used the data 
must be put onto the data pad bus, and from there moved to a register 
or memory. 


Example: 


IN; DPX(2)<INBS "READ 1/0 DATA INTO DPX 
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1.6.13.3 SENSE 


Purpose: sensing an I/0 device condition 


Op=codes Function 

SNSA SeNSe condition A 

SPINA SPIN on condition A 

SNSADA SeNSe condition A, then set DA to spfn 
SPNADA SPIN on condition A, then set DA to spfn 
SNSB SeNSe condition B 

SPINB SPIN on condition B 

SNSBDA SeNSe condition B, then set DA to spfn 
SPNBDA SPIN on condition B, then set DA to spfn 


1.6.13.4 FLAG 


Purpose: set/reset of program flags 


Op-codes Function 
SFLO Set Flag 0 
SFL1 Set Flag l 
SFL2 Set Flag 2 
SFL3 Set Flag 3 
CFLO Clear Flag 0 
CFL1 Clear Flag 1 
CFL2 Clear Flag 2 
CFL3 Clear Flag 3 


FPS 860-7292-002 Ll = 47 


1.6-13.5 CONTROL 


Purpose: miscellaneous control functions 


Op-code Functions 

HALT HALT processor 

IORST ‘ I/O ReSeT 

INTEN INTerrupt ENable 

INTA INTerrupt Acknowledge 

REFR memory REFResh synch 

WRTEX enable WRiTe of Exponent only into DPX, DPY or MI 
WRIMN enable WRiTe of MaNtissa only into DPX, DPY or MI 
SPMDAV SPin until a Main Data memory cycle AVailable 


1.6-13.6 Miscellaneous 


Purpose: miscellaneous control functions 


Op-codes Functions 
REXIT read subroutine exit into panel bus 


1.6.14 TABLE MEMORY 


This section lists the constants and functions available in table 
memory. 
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1.6-14.1 Constants 


CONSTANT 


REPRESENTED 


SQRT (10) 
1.0/SQRT (2) 
1. 0/SQRT (3) 
I.0/SQRT (5) 
I.0/SQRT (10) 
CBRT (2) 
CBRT (3) 
(2.0) **1/4 
LOG2(E) 
LOG10(2) 
LOG10(E) 

LN (2) 

LN (3) 

LN (10) 

E 

1.0/E 
EB **2 
Pl 
2*PT 
I.0/PL 
P1/2 
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VALUE IN 


TABLE MEMORY 


WAN AUF WNr © 


e e e e e e e e e 


goooqoo0o O00 0 0 


¢ 333333333 
ONE FOURTH 
0.2 

0. 166666667 
0. 142857143 
0.125 
0.111111111 
0.1 

0.0625 
1.414213562 
1. 732050808 
2. 236067977 
3. 162277660 
0. 707106781 
0. 577350269 
0.447213596 
0.316227766 
1.259921050 
1.442249570 
1.189207115 
1.442695041 
0. 301029996 
0. 434294482 
0. 693147181 
1.098612289 
2. 302585093 
2. 718281828 
0. 367879441 
7389056096 
3- 141592654 
6. 283185308 
0. 318309886 
1.570796327 


li = 49 


2K TABLE MEMORY 


ROM ADDRESS (OCTAL) 


4371 
4001 
4002 
444] 
4442 
4443 
4444 
4445 
4446 
4447 
4450 
4451 
4427 
4430 
0.254431 
4432 
4433 
4434 
4435 
4436 
4437 
4440 
4203 
4422 
4423 
4424 
4206 
4452 
4453 
4454 
4417 
4420 
4421 
4317 
4411 
4337 
4336 
4407 
4410 
4403 
4404 
4405 
4402 
4415 
4412 
4312 


1PI4 
1PII 80 
1PISQ 
iSQTPL 
{LNPI 
{GAMMA 
{PHI 


PI /4 

PI /180 
PI **2 
SQRT (PL) 
LN (PI) 
GAMMA 
PHI 


0. 785398164 
0.017453293 
9. 869604404 
1. 772453851 
1. 144729886 


0.577215663 


1. 618033989 


1.6.14.2 Elementary Function Tables 


SYMBOL 


IDIV 
!SQRT 
!SNCS 
!LOG 
!EXP 
!ATAN 


ELEMENTARY 
FUNCTION 


DIVIDE 
SQUARE ROOT 
SIN /COS /4306 
LOGARITHM 
EXPONENT LAL 
ARC TANGENT 


1.6614.3 Size 


SYMBOL 


lFFTSZ 


SIZE (TYPICAL ) 


TABLE MEMORY 
ADDRESS (OCTAL) 


4000 
4202 


4333 
4317 
4365 __ 


of Installed FFT Cosine Table 


2048 = 4000 (octal) 
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4373 
4413 
4414 


4416 


4406 
4425 
4426 


CHAPTER 2 


APLINK 


2-1 INTRODUCTION 


APLINK links together separate object modules produced by APAL into a 
Single load module for execution by the AP hardware or the simulator. 


The user can separately code and assemble a main line program and the 
associated subroutines and later link them together for execution. 
APLINK serves this purpose by performing the following tasks: 
e relocating each object module and assigning absolute addresses 
e linking the modules together by correlating global entry symbols 
defined in one module with external symbols referenced in 
another module 


e selectively loading modules from program library 


e optionally producing a load map showing the layout of the load 
module 


APLINK is written in FORTRAN IV and requires approximately LOK of 
memory. 
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2-2 OPERATING PROCEDURE 


Program modules are linked interactively via a dialogue between the 
user and APLINK. The user enters a series of commands which direct the 
linking process. 


When execution begias, APLINK outputs: 


APLINK 


version 
* 


The version is the version number of APLINK. The asterisk (*) 
indicates that the program is ready to accept commands. After each 
user command, an * is output when that command has been executed and 
APAL is ready for a new command. An illegal command causes a "?" to 
be output. 


To load relocatable programs and prepare them for execution, the user 
would normally follow the procedure outlined below. 


1. Using the L (load) command, load the file or files containing 
the desired main program, required subroutines, and library 
subprograms, if any- If a fatal error occurs during this step, 
reinitialize using the R command and repeat this step. 


2. Using the U (undefined) command, check to see if any global 
symbols are still undefined. If nothing is output from this 
command, continue to step 3. If any symbols are output, it 
usually means that there was an error in one or more of the 
programs loaded or that the loading sequence was wrong. In 
these cases, correct the error and restart the loading operation 
from step l. 


3. Obtain the memory limits of the loaded program or a loader map 
by using the M (memory) or S (symbols) command. 


4. Complete and output the load module by using the E (end) or 
by A command. Note the values of HIGH and START as well as the 
possible presence of any remaining undefined symbols. 


5- Return to the operating system-with an X (exit) command. 
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The individual APLINK commands are described in the following 


subsections, and a complete example loading session is given in 
section 2.2.12. 


The following abbreviations are used in the following sub-sections: 


Abbreviations Meaning 
(filename) A user-specified input or output file. The 


(filename) follows whatever naming conventions 
exist for the particular host computer 
operating systems. 

(cr) carriage return 


This is the terminal prompt indicating 
that the terminal is ready for input. 


peice aseee Indicates characters output by 
the program. 


The examples given are illustrative only, as file and I/0 device names 
vary from system to system. 


202.1 LOAD L 


To load a program module, or a program library, enter: 


L (cr) 
(filename) (cr) 


where (filename) is the name of the file containing the desired program 
or library. 


Example: 
* 
L (cr) 
FFT.RB (cr) 


This example loads the program contained on file FFT.RB. 


In loading routines, the first entry point defined becomes the name of 
the host source output. An entry point may be defined by doing a force 
(F) without having loaded an object module previously. 
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2.2.2 SYMBOLS S$ 


To output the global (external and entry) symbols enter: 


S (cr) 
(filename) (cr) 


where (filename) is the name of the file (or I/0 device) to receive the 
symbol listing. The output of the loader map is as follows. 


HIGH = aaaaaa 


SYMBOL TABLE 
SYMBOL VALUE 
ssssss nonnnon 
where: 
aaaaaa highest program address so far loaded. Normally, 


the next program is loaded starting at location HIGH+l. 
ssssss symbol name 


nnnnon symbol value; if undefined, the last location 
loaded which referenced this symbol. 


U if present indicates the symbol is as 
yet undefined. 


Example: 


This example lists the loader symbol table at the terminal. 
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2.2.3 UNDEFINED U 


To output to the console any presently undefined global symbols, enter: 


U (cr) 
(filename) (cr) 


where (filename) is the file to receive the list of undefined symbols. 
The list format is: 


ssssss nnnnnan 


where ssssss is the symbol name and nnnnnn is the location of the last 
program instruction which referenced the symbol. 


Example: 


® 


T (cr) 
TP: (cr) 


This example lists the names of any undefined symbols at the terminal. 


2.264 NEXT BASE B 
To specify a base address at which to load the next program, enter: 


B (cr) 
(loc) (cr) 


where (loc) is the location specified. 


Example: 
* 
B (cr) 
200 (cr) 


This example sets the next location loaded to location 200. 
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2-2-5 RESET R 
To reset APLINK, enter: 
R(cr) 
This reinitializes the program to its initial state. The symbol table 
is cleared, any previously loaded programs are disregarded, and the 


next location is set to zeroe This command must be given following a 
fatal error. 


2.226 FORCE F 
To force loading of a program module from a library, enter: 


F (cr) 
(name) (cr) 


where (name) is the name of the symbol to be forced. This command 
enters (name) into the symbol table as an external symbol. This causes 
the loading of a library program which has (name) as an entry symbol. 
Example: 

* 

F(cr) 

DOTPRD (cr) 


forces the loading of any program defining symbol DOTPRD from any 
subsequently loaded library file. 


2.2.7 MEMORY M 


To get the address of the highest program source memory location so far 
loaded, enter: 


M (cr) 


The information is printed as follows: 
HIGH = aaaaaa 


where aaaaaa is the highest address so far loaded, and bbbbbb, if 
present, is the load module starting address. 
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2.2.8 END E 


To end a load module and output the completed load module for use with 
APDBUG or APSIM, enter: 


E (cr) 
(filename) (cr) 


where (filename) is the name of the file to receive the loader output. 
The output is a core image which can be loaded by APDBUG and executed 
by either the simulator APSIM or the hardware. 


APLINK outputs the following information to the user console: 
HIGH = aaaaaa 


where aaaaaa is the highest program address loaded. If any symbols 
were still undefined, APLINK outputs: 


(num) UNDEFINED SYMBOLS 


where (num) is the number still undefined. A value of 0 was used in 
linking these undefined symbols. 


Example: 


* 


# (cr) 
SAVE 


Stores the completed load module into file SAVE. 

The E (or A) command causes links between global symbols in the 
completed load module to be frozen-e The load module can be output 
again (with another E or A) but no further links can be added (with an 
L). 


To work on another load module a reset (R) command must be given to 
clear the linker. 
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2.2.9 END WITH ASSEMBLY CODE A 


To end a load module and output the completed load module as host 
computer assembly code (for use with APEX), enter: 


A (er) 
(filename) (cr) 


where (filename) is the name of the file to receive the loader output. 
This output is a short host assembly (or possibly FORTRAN) language 
subroutine, which is the linkage between host computer FORTRAN calls 
and the AP executive. The AP code from the load module follows the 
host subroutine as assembly language data statements. 


Information concerning the highest address loaded into, and any 


undefined symbols, are output to the user console as described above 
for the E command. 


222-10 NUMBER RADIX N 


To set the radix for numeric input/output to and from the user console, 
enter: 


N (cr) 
(radix) (cr) 


where (radix) is either 8 (for octal), 10 (for decimal), or 16 (for 


hexadecimal). The default radix for user I/0 is set to either of these 
choices at installation. 


22-11 EXIT X 
To exit to the operating system, enter: 
X(cr) 


Notice that the X command does not cause any output. The E or A 
command must be used to output a load module. 


FPS 860-7292-002 2=- 8 


222.12 AN EXAMPLE LOADING SESSION 


OK, APLINK 


PROGL.OBJ 
* 

U 

TTY 


DIV 000004 _ JU 
# 


L 
APLIB 


LOAD COMPLETE 
* 


S 
TTY 
HIGH=000042 


SYMBOL TABLE 


SYMBOL VALUE 
PROGI1 000000 


DIV 000007 
x 


E 
PROG 1. SOURCE 


PROG] HIGH=000042 


* 


A 
PROG1.APSIM 


PROG] HIGH=000042 


*& 


x 
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Call LINKER 


Load PROG1.OBJ 


Output any undefined symbols 
to the terminal 


DIV subroutine is undefined 


Load DIV 
from subroutine library 


Output global External and Entry symbols 


Create PROGI1.APSIM to run on the simulator 


Create PROGI1.SOURCE (host FORTRAN or assembler) 
to run on host system 


End (Return to the operating system) 


2.3 ERROR MESSAGES 

Any deviation from the prescribed command syntax causes APLINK to 
output a "?" to the user console. The illegal command is ignored, and 
APLINK outputs a "*" to indicate its readiness to accept a new command. 
If a specified filename cannot be found or is otherwise unavailable for 
use, the message: 


FILE NOT FOUND!!! 


is output and the command is ignored. 


The specific error messages output by APLINK are the result of loading 
errors detected during execution of an L (load) command. There are two 
classes of loading errors: 


F - fatal. Reinitialization of the loader (the R 
command) is required before loading can 
continue. 


W - warning. An advisory message indicating a 
non~error. 


Any fatal error detected during loading causes immediate termination of 
the L (load) command following the error message. If the user attempts 
to execute another L command, the program outputs the message: 


RESET!!! 


and ignores the command. After the user reinitializes the loader (R 
command), he must reload any programs loaded up to that point. 
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Following are the error messages, along with notes of explanation for 
each: 


F SYMBOL TABLE OVERFLOW 


The loader symbol table is full. The only recourse is to 
recompile APLINK with a longer symbol table size. 


F PROGRAM MEMORY OVERFLOW nnonnnn 


An attempt was made to load the upper limit of program source 
memorye The load module is too large to fit in program source 
memorye mnnnnn is the memory location involved. 


F OVERWRITE nnnnnn 


An attempt was made to overwrite a previously loaded program 
memory location.- The loader does not permit any given program 
memory location to be loaded more than oncee nnnnnn is the 
program memory location involved. 


F ILLEGAL BLOCK TYPE nnnnnn 
An illegal relocatable object code block type was encountered. 


The file specified does not contain legal object code- nnnnnn is 
the illegal block type, as read from the block header in question. 
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W MULTIPLE ENTRY 
An SENTRY symbol having the same name as one already defined was 
encountered during a load. The name and value of the symbol is 
output to the terminal as follows: 


ssssss nnannn 


where ssssss is the symbol name and nnnnnn the symbol value. The 
loader proceeds by ignoring the latest definition. 


W MISSING OR IMPROPER ENTRY 


The user attempted to produce host assembly code (an A command) 
from a load module and one of the following was true: 


e The load module did not have any entry points (defined 
entry global symbols). 


e The first entry point loaded did not have an s-pad 
parameter count. 


2-4 SUMMARY OF APLINK COMMANDS 


This section contains a summary of APLINK commands. The following 
abbreviations are used in this section. 


Abbreviation Meaning 
(cr) carriage return 
(filename) name of a file, as appropriate for the host 


operating system being used 


(loc) a location, octal or hex decimal as 
appropriate 
(name) a symbol name, six characters or less 
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Command 


L(er) 
(filename) (cr) 


S (cr) 
(filename) (cr) 


U(cr) 
(filename) (cr) 


B(cr) 
(loc) (cr) 


R(cr) 


F(cr) 
(name) (cr) 


M(cr) 


E (er) 
(filename) (cr) 


- A(er) 


(filename) (cr) 


N(er) 
(number) (cr) 


(X) (er) 
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Effect 


load the program in file (filename), link 
with previously loaded programs. 


output the loader symbol table to file 
(filename) 


output any undefined symbols to file 
(filename) 


set APLINK to load the next program at 
location (loc). 


reset the loader. 


force the loading of a program defining symbol; 
name from any subsequent program libraries loaded. 


output the highest program memory location used. 


end the loading session; store the resulting 
load module into file (filename). 


end the loading session; output host computer 
assembly code for use with APEX into file 
(filename). 


set the radix for numeric user consol 1/0 
to either 8, 10, or 16. 


exit to the operating system. 


2-5 RELOCATABLE OBJECT CODE BLOCK TYPES 


Unlike most relocatable binary, the relocatable object code produced by 
APAL consists of numbers written as decimal integer characters. Those 
were output (and readable) by FORTRAN formatted I/O statements. 


An advantage of this type of code is that relocatable library files can 
be edited with an ordinary text editor. This makes unnecessary the 
need for a special-purpose library of library file editor. 


The relocatable object code is divided into a series of blocks. The 
order in which blocks appear, if each type is present, is as follows 
(the block type number is in parenthesis): 


1. title blocks (3) 

2- entry blocks (4) 

3- code blocks (0) 

4. external blocks (5) 
5e end block (1) 


An object module contains at least a title block and an end block. The 
presence of one or more of the other block types depends upon the 
particular program. 


The first line of each block is a block header, which contains four 
seven-digit numbers: 


l. block type numbers 

2- number of items in the block 
3. initial address, if relevant 
4. unused 


In addition, the block header is flagged with "***" to aid in 
identification of blocks. 


Each block type is described on the following page, in numeric order by 
block type numbers. 
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2-5-1 CODE BLOCK (0) 


Line 


Each code line contains a 64-bit program source word. 


2.5.2 END BLOCK (1) 
Line 


0 


2.5.3 TITLE BLOCK (3) 
Line 


0 
1 


FPS 860-7292-002 


0-15 


Contents: 


count address 
Bits 16-31/Bits 48-63 
ih] w 


Contents 


0 0 


Contents 


Qxex 


O***TITLE 


2-5-4 ENTRY SYMBOL BLOCK (4) 


Line 


0 
1 


225.5 EXTERNAL SYMBOL BLOCK (5) 


Line 


2-566 LIBRARY START BLOCK(6) 


Line 


0 


2.5.7 LIBRARY END BLOCK (7) 


Line 


0 
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Contents 


count 
value 


we 


Contents 


count 
link 
wt 


Contents 


0 


Contents 


0 


16 


Oxax 


#S—Pad 


parameters 
" 


Oxe* 


Qxkex 


Oxex 


225.8 EXAMPLE RELOCATABLE OBJECT PROGRAM 


The object module is an ASCl1l file and therefore can be modified with 
the text editor. 


ka&X 


l. 0. Q.***TITLE > 1. Title 

0. 

1. 0. 0. ##x 2. Entry Block 
0; 3. 


4. External Block 


5- End Block 


76 0. 0. #*% 

0. 0. 48. 

0. 0. 48. 

0. 0. 0. 

QO. 6656. 32768. 3. Code Block 


indicates a new block 


l. 


Ze 


36 


4e 


Se 


The title block contains the title of the program, PROGI. 


The entry block has the name of the entry point, PROG1; 
its relative adress, 0; and the number of expected 
S-pad parameters, 3. 


The code block contains the seven AP program words in 
PROG], each as four l6<bit quarters of a 64—bit 
program word. 


The external block contains the external symbol DIV. 


The end block tells APLINK that it has reached the end 
of the program. 
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2-5-9 EXAMPLE OF E OUTPUT 

Example output from APLINK produced by an E (end) command from a 
program, PROG1, follows. APDBUG can load this output into either the 
Simulated AP (APSIM), or the actual hardware for debugging. 


The first line says that the program contains 35 program words. 


35. 

16384. 00000. 00000. 00048. 
16452. 00000. 00000. 00048. 
00000. 00000. Q0000. 00000. 
00000. Q0Q000. 06656. 32768. 
04620. 00000. 18948. 00003. 
16520. Q0000- 01792. 00240. 
00000. 00224. 00000. 00000. 
00956. 21504. 01280. 02050. 
QOOOL. 32768. 06176. 32768. 
00951. 34304. 33796. 02048. 
01016. 00286. 01792. 00000. 
09148. 00000. 00000. 00003. 
00574. 52224. 00256. 00000. 
00001. 32768. 00032. 07680. 
00628. 00000. 00000. 07171. 
00888. 00000. 01792. 04096. 
04112. Q0018. 12288. 36864. 
00761. 54866. 49188. 00000. 
00761. 22016. 49188. 00000. 


00637. 17408. 00256. 05376. 
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00632. 


00637. 


00001. 
00001. 
00831. 
00064. 
00952. 
255356 
00000. 
00000. 
00001. 
00000. 
00000. 
00000. 


00000. 
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00000. 
24064. 
37376. 
32853. 
39936. 
00000. 
00000. 
35925. 
00000. 
37376. 
32768. 
00000. 
00000. 
00000. 


00224. 


27653. 
00320. 
00256. 
00032. 
17412. 
05888. 
01024. 
03360. 
00000. 
00000. 
00000. 
00000. 
00000. 
00000. 


49156. 


36864. 
04096. 
04352. 
06144. 
01023. 
32768. 


08192. 


- 05632. 


04096. 
04096. 
00000. 
04096. 
04096. 
04096. 


00000. 


19 


2.5.10 EXAMPLE OF APLINK SOURCE OUTPUT 


SUBROUTINE PROGL (I 
x 1,I 2,1 
xX 3) 
INTEGER CODE( 141) 
INTEGER I 1,J 1 
INTEGER I 2,J 2 
INTEGER I 3,J 3 
INTEGER SLIST (16) 
COMMON /SPARY/SLIST 
EQUIVALENCE (J 1,SLIST( 1)) 
EQUIVALENCE (J 2,SLIST( 2)) 
EQUIVALENCE (J 3,SLIST( 3)) 
DATA CODE(1) / 35/ 
DATA CODE ( 2) , CODE ( 3), CODE ( 4), CODE ( 5)/ 
:040000, :000000, : 000000, :000060/ 
DATA CODE ( 6) , CODE ( 7) ,CODE ( 8), CODE ( 9)/ 
X :040104, :000000, :000000, :000060/ 
DATA CODE( 10),CODE( 11),CODE( 12),CODE( 13)/ 
: 000000, : 000000, :000000, :000000/ 
DATA CODE( 14),CODE( 15),CODE( 16),CODE( 17)/ 
X :000000, :000000, : 015000, :100000/ 
DATA CODE( 18),CODE( 19),CODE( 20),CODE( 21)/ 
X :011014, :000000, :045004, :000003/ 
DATA CODE( 22),CODE( 23),CODE( 24),CODE( 25)/ 
X 3040210, 000000, :003400, :000360/ 
DATA CODE( 26),CODE( 27),CODE( 28),CODE( 29)/ 
X :000000, :000340, : 000000, :000000/ 
DATA CODE( 30),CODE( 31),CODE( 32),CODE( 33)/ 
KX :001674, :052000, :002400, :004002/ 
DATA CODE( 34),CODE( 35),CODE( 36),CODE( 37)/ 
X :000001, :100000, :014040, :100000/ 
DATA CODE( 38),CODE( 39),CODE( 40),CODE( 41)/ 
X :001667, :103000, :102004, :004000/ 
DATA CODE( 42),CODE( 43),CODE( 44),CODE( 45)/ 
:001770, :000436, :003400, :000000/ 
DATA CODE( 46),CODE( 47),CODE( 48),CODE( 49)/ 
7021674, :000000, :000000, :000003/ 
DATA CODE( 50),CODE( 51),CODE( 52),CODE( 53)/ 
2001076, :146000, :000400, :000000/ 
DATA CODE( 54),CODE( 55),CODE( 56),CODE( 57)/ 
3000001, : 100000, :000040, :017000/ 
DATA CODE( 58),CODE( 59),CODE( 60),CODE( 61)/ 
X 3001164, :000000, :000000, :016003/ 
DATA CODE( 62),CODE( 63),CODE{ 64),CODE( 65)/ 
X 3001570, :000000, :003400, :010000/ 
DATA CODE( 66),CODE( 67),CODE( 68),CODE( 69)/ 
X :010020, :000022, :030000, :110000/ 
DATA CODE( 70),CODE( 71),CODE( 72),CODE( 73)/ 
X :001371, 3153122, 3140044, :000000/ 
DATA CODE( 74),CODE( 75),CODE( 76),CODE( 77)/ 


va 


a 


a Va ms 


a 
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Has] 


2001371, :053000, :140044, :000000/ 
DATA CODE ( 78 ) ,CODE ( 79) , CODE ( 
2001175, :042000, :000400, :012400/ 
DATA CODE( 82), CODE ( 83) , CODE ( 
2001170, :000000, :066005, :110000/ 
DATA CODE ( 86) , CODE ( 87), CODE ( 
X :001175, :057000, :000500, :010000/ 
DATA CODE ( 90) , CODE ( 91) ,CODE ( 
X :000001, :111000, :000400, :010400/ 
DATA CODE ( 94), CODE ( 95), CODE ( 
X :000001, :100125, :000040, :014000/ 
DATA CODE ( 98) ,CODE ( 99) , CODE ( 
X :001477,:116000, :042004, :001777/ 
DATA CODE( 102),CODE( 103),CODE( 
X :000100, :000000, :013400, :100000/ 
DATA CODE( 106),CODE( 107),CODE( 
X :001670, :000000, :002000, :020000/ 
DATA CODE( 110),CODE( 111),CODE( 
X :061677, :106125, :006440, :013000/ 
DATA CODE( 114),CODE( 115),CODE( 
X :000000, :000000, :000000, :010000/ 
DATA CODE( 118),CODE( 119),CODE( 
X :000000,:111000, :000000, :010000/ 
DATA CODE( 122),CODE( 123),CODE( 
X :000001, :100000, :000000, :000000/ 
DATA CODE( 126),CODE( 127),CODE( 
X :000000, :000000, :000000, :010000/ 
DATA CODE( 130),CODE( 131),CODE( 
X :000000, :000000, :000000, :010000/ 
DATA CODE( 134),CODE( 135),CODE( 
X :000000, : 000000, :000000, :010000/ 
DATA CODE( 138),CODE( 139),CODE( 
X :000000, :000340, :140004, :000000/ 
J 1=I 1 
J 2=I 2 
J 3=I 3 
CALL APEX(CODE, 0,SLIST, 3) 
RETURN 
END 


| 


as] 


FPS 860-7292-002 2 2 ai 


80) , CODE ( 
84), CODE ( 
88) , CODE ( 
92) , CODE ( 
96) ,CODE ( 
100) , CODE ( 
104) , CODE ( 
108) ,CODE ( 
112), CODE ( 
116) , CODE ( 
120) , CODE ( 
124) , CODE ( 
128), CODE ( 
132) , CODE ( 
136) , CODE ( 


140) , CODE ( 


81)/ 
85)/ 
89) / 
93)/ 
97)/ 
101)/ 
105)/ 
109)/ 
113)/ 
117)/ 
121)/ 
125)/ 
129)/ 
133)/ 
137)/ 


141) / 


The APLINK source consists of four basic parts: the SUBROUTINE start, 
SLIST array, CODE array, and the APEX call. 


The subroutine start contains this routine’s arguments, the number of 
which corresponds to the s-pad parameter with the first SENTRY start in 
the APAL code. The subroutine name is the SENTRY symbol so that when 
the user calls PROGI, control is passed through this host source 
routine which then causes the execution of the previously loaded APAL 
code of the same name. At run time the arguments are transferred to 
the SLIST array. These are usually addresses of data already in the AP 
via APPUT calls in other routines. The code array contains the load 
module created by the user, in this case - PROGI1 and the DIV routines. 
The first element of the array is the number of AP program source 
words; the following values correspond to the actual microcode. 


The APEX calls cause the micro=-code to be loaded into AP program source 
memory unless it still resides there from previous calls. The 
arguments values are placed in their respective s-pad registers (16 is 
maximum), and control is finally passed to the routine entry point. 
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CHAPTER 3 


APSIM AND APDBUG 


3.1 INTRODUCTION 


APSIM and APDBUG provide an interactive facility for checking out AP 
programs. The user can run portions of his AP program, stop and 
examine the results, make program patches, and then continue with 
program executione The process of interactive debugging greatly 
facilitates preparation of correctly operating AP programs. 


APSIM and APDBUG have commands to: 


e examine or change memory locations and registers 
inside the AP 


® type out memory contents and integers, floating point 
numbers or program word fields 


_@ set, clear and examine breakpoints 


@® run programs, or execute them one step at a time 


APSIM and APDBUG are actually independent debugging systems. However, 
the virtually identical input commands justify combining their 
descriptions. 


APSIM is useful for initial program development and has the advantage 
that it allows debugging off-line from the AP hardware. It allows 
access to more internal AP registers than with the hardware. 

Simulation is limited, however, to program execution inside the AP. 
Input/output interaction with the host computer is not simulated. 
Depending on the speed of the host computer, the simulator runs about 
one million times slower than real time or about six instruction cycles 
per second. 


APDBUG is useful for debugging AP programs which require long execution 
times and/or real-time interaction with the host computer. 


This chapter describes Release 2.1 of APSIM-APDBUG. As usual (cr) 
means carriage return or end of line, as appropriate to the particular 
host computer system. In the examples listed, the responses output by 
the computer are underlined. 
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3.2 OPERATING PROCEDURE 

Debugging is the process of detecting, locating, and removing mistakes 
from a programe When the programmer wishes to debug an AP program, he 
loads the program into APDBUG (or APSIM). He may then control program 
execution, causing the program to breakpoint at selected program 
locations so that the contents of registers or memory locations can be 
examined. Contents may be examined as program words, integers, or 
floating-point numbers. 


APDBUG (or APSIM) types an asterisk (*) when ready for user input. A 
question mark (?) is typed when an error is detected. 


3-2-1 MONITORING REGISTERS AND MEMORY LOCATIONS 
Registers and memory locations in the AP may be opened, examined and 
modified using one of the following commands: 


Command Function 


E open and examine locations in the AP 

+ examine the next higher location in an AP memory 
- examine the next lower location in an AP memory 
C change the open location 

° re-examine the currently open location 

Z zero out all AP registers and memories 


O set program source memory offset 


A register in the AP is opened with an E (exam), + (next), or - (last) 
command. APDBUG (or APSIM) gets the value of the desired location in 
the AP and outputs the value at the terminal. If desired, the contents 
of the location may be changed with a C (change) command. A. 
(re~exam) lists the contents of the open register. 
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3.2.2 OPEN AND EXAMINE (E) 
To open and examine a register in the AP enter: 


E (cr) 
(name) (cr) 


where (name) is the name of the desired register. 


To open and examine a memory location in the AP enter: 


E (cr) 
(name) (cr) 
(location) (cr) 


where (name) is the memory name and (location) is the desired memory 
location. 


A list of the examinable registers and memories and their description 
is given in Section 3.4.5. For the purposes of APDBUG, all functional 
units of the AP which have addresses are considered memories. This 
includes the three obvious memories (main data memory, table memory and 
program memory) plus data pad X, data pad Y and s-pad. 


Examples: 
e Examine main data memory location 23. 


* 
E (cr) 
MD (cr) 
23 (cr) 


-234.0000000 
* 


MD location 23 contains ~-234.0. 


e Examine the memory address register. 


* 
E (er) 
MA (cr) 
1376 

* 


MA contains 1376. 
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322.3 EXAMINE NEXT, LAST AND RE=EXAMINE (+, -, -) 


To open and examine the next higher sequential memory location above a 
currently open memory location enter: 


+ (cr) 


To open and examine the next lower sequential memory location below a 
currently open memory location enter: 


- (cr) 


To re-examine the currently open memory location enter: 


- (cr) 
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Examples: 


e Examine main data memory locations 23 and 24. 


* 
E (er) 

MD (cr) 

23 (cr) 
~234.0000000 
# 


MD location 23 contains -234.0; now examine MD location 24. 


* 
+ (cr) 
MD 000024 


789.0000000 
* 


MD location contains 789.0. 


e Examine s-pad registers 7 and 6. 


* 
E (cr) 
SP (cr) 
7 (er) 
000027 
* 


S-pad register 7 contains 27. Now examine register 6. 


& 

- (cr) 

SP 000006 
-136 

* 


S-pad register 6 contains -136. 
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3.2.4 CHANGE (C) 


To change the contents of a currently open register or memory location 
to a specified value enter: 


C (cr) 
(value) (cr) 


where (value) is an integer or floating-point number (depending upon 
what register or memory is open). (See Section 3.2.2.) 


To change a register or memory location the user must first open it by 
doing an E, + or = command. 


Examples: 


e Examine main data memory location 20 and then change its value 
to ~97.5- 


* 
E (cr) 
MD (cr) 
20 (cr) 
7600000000 
* 

C (cr) 


-97. 5 (cr) 
* 


Main data memory location 20 contained 76.0. The user 
changed it to contain -97.5. 
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e Now change main data memory location 21 to -63.4. 


re 
+ (cr) 

MD 000020 

= 3.000000000 
* 

C (cr) 
-63.4 (cr) 

* 


MD location 21 contained -3.0 and was changed to 
contain -63.4. 


e Examine s-pad register 3 and change its value to 17. 


= 
E (cr) 
SP (cr) 
3. (er) 
56 
= 
C (cer) 
17 (cr) 
* 


S-pad register 3 contained 56 and was changed to contain 17. 
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3-2.5 SET PROGRAM SOURCE OFFSET (0) 
To set the program source memory addressing offset enter: 


8) (cr) 
(value) (cr) 


where (value) is an integer in the current radix specifying the offset 
to be used when accessing program memory. The default setting is 0. 


The offset is used when debugging a load module containing several 
separately assembled programs. For example, assume that programs A, B, 
and C have been loaded together with APLINK and the following load map 
obtained from APLINK with the S command. 


SYMBOL VALUE 


A 000000 
B 000153 
C 000247 


This means that program A was loaded at PS location 0, B at location 
153, and C at location 247. . 


To examine locations 3 and 4 of program B, type: 


* 

E (cr) 

PS (cr) 

156 (er) 

000000 000000 000000 000000 
* 

+ (er) 

PS 000157 

000000 000000 000000 000000 
ry 
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This may become confusing because locations 156 and 157, printed by 
APDBUG (or APSIM) don’t agree with the APAL listings which always start 
at zero.- The offset simplifies matters by adjusting the base address 
for all PS related I/O. Thus, for conventence-sake, the offset should 
be set to the base address of the program currently being examined. 


x 
0 (cr) 

153 (er) 

* 

E (er) 

PS (cr) 

3 (cr) 

000000 000000 000000 000000 
* 

+ (cr) 

PS 000004 

000000 000000 000000 000000 


| + 


The offset applies to examining or changing PS and PSA and also to 
breakpoints and running programs. It should be remembered, when 
setting the offset, that it is not relative to itself, but is an 
absolute address. Thus, the offset can always be reset to the default 
value of zero by typing the following: 


QO (er) 
0 (er) 
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3.2.6 CHANGING INPUT/OUTPUT FORMATS 


The input and output format used when examining and changing registers 
and memory locations may be selected using the following commands: 


Command Function 
N sets the radix for integers 
F sets the format for input/output of 38-bit wide 


registers and memory words 


V sets the format for input/output of 64-bit wide 
program memory words 


APDBUG selects the proper format for input/output depending on the word 
size of the particular register or memory location that is open and the 
setting of the previous three commands as follows. 


e 16=—bit words | MA, TMA, DPA, s-pad, etc. These locations 
are examined or changed as integers 
in the radix as selected by N. 


e 38=bit words DPX, DPY, main data memory, table memory, 
etc. These locations are examined 
or changed as either floating-point 
numbers or as three integers, depending 
upon the F command. 


e 64-bit words program memory. These locations are 
examined or changed as either opcode 
fields or as four l6<bit integers 
depending upon the V command. 
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The listing of accessible AP register and memories in Section 3.4.5 
specifies the width of each as one of the following: 


l6=bit (integer word) 
38-bit (floating point word) 
64=bit (program word) 


NOTE 


Integer output is always unsigned on the range 
0-177777 (octal), or 0-65536 (decimal), or 
O-FFFF (hexadecimal). Thus, negative twos 
complement numbers are typed out as their 
l6=bit unsigned equivalents. For example (in 
octal) -1 would be output as 177777, and <2 as 
177776, and so forth. 


3-2-7 SET RADIX (N) 

To set the radix for all integers input/output to APDBUG enter: 
N (cr) 
(radix) (cr) 


where (radix) is either 8, 10 or 16 for octal, decimal or hexadecimal 
radixes respectively. (radix) is always entered as a decimal value. 


The contents of l16<bit wide registers (s-pad, MA, PSA, etc.) are 
examined and changed using the integer radix as set by the N command. 
In addition, memory addresses are also entered using the current radix. 


On listings, octal numbers may be recognized as having six digits, 
decimal numbers as having five digits and hexadecimal numbers as having 
four digits. 


The default radix is either octal or hexadecimal depending upon the 
conventions of the host computer. 
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Examples: 


e Examine s-pad register 10 (decimal) in all three radixes 
(starting in decimal). 


< 
E (cr) 
SP (cr) 
10 (cr) 
32768 
= 
N (cr) 
8 (cr) 
id 

(cr) 


SP 000012 
100000 
* 


N (er) 

16 (er) 

= 

‘ (cr) 

SP 000A 


8000 
* 


The value of s=-pad register 10 is 32768 (decimal) 
or 100000 (octal) or 8000 (hexadecimal). 
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3.2.8 SET/RESET FLOATING POINT I/O (F) 


To select floating-point input/output of 38-bit registers and memory 
words enter: 


F (cr) 
1 (er) 
To select integer input/output (in the current integer radix) of 38-bit 


wide registers and memory locations enter: 


F (cr) 
O (cr) 


38-bit wide registers are split into three pieces: 10-bit exponent, 
12-bit high mantissa (bits 0-11) and 16-bit low exponent (bits 12-27) 
for integer 1/0. 


Data pad, main data memory, table memory and data pad bus are among the 
registers and memories whose 1/0 is governed by the F command. 


Both examining and changing of 38=bit registers are effected by F. The 
default setting of the F command is one (for floating-point 1/0). 


e Examine command output formats. 
F=l1: (floating-point number) 


F=0: (exponent) (high mantissa) (low mantissa) 


e Change command input formats. 


F=1: C (ery. 
(floating point number) (cr) 
F=0; C (cr) 
(exponent ) (cr) 


(high mantissa) (cr) 
(low mantissa) (cr) 
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legal floating point numbers are of the form 


+KXX. YYE+ZZ 


where: 


XX is the integer part 
YY is the fraction part 
ZZ is the exponent 


Any of the three parts may be omitted, except in the case when an 
exponent is used. In this case, either an integer part or a fraction 
part must also be included. The signs may be omitted if + is used. 
The decimal point may be omitted if not needed. No spaces are allowed 
inside floating-point numbers. The following are all legal 
floating-point inputs. 


~2.3E6 
- JE=3 
~2 
3.65 
27 


Examples: 


e Examine data pad register six in both floating point 
and integer. (Assume the integer radix is 16.) 


* 
E (cr) 
DPX (cr) 
6 (cr) 
-1.000000000 
F (er) 
0 (er) 
* 
i (er) 
DPX 0006 
0200 0400 0000 
* 
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DPX register six contains -1.0. Its exponent is 200 (hexadecimal) 
which has an exponent value of zero (0). The fraction part is 4000000 
(hexadecimal) which is a fraction of ~-1.0. 


e Now change the exponent to 204 and the fraction to 
2000000 and set F to l. 


* 
C (cr) 

204 (cr) 

200 (cr) 

0 (cr) 

* 

F (cr) 

1 (er) 

* 

i (cr) 

DPX 0006 
8.000000000 
* 


DPX register now contains 8.0 which is 0.5%*2*%*4. 
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3.2.9 SET/RESET PROGRAM WORD FIELD 1/0 (V) 


To select input/output of 64-bit wide programs words by op=-code fields 
enter: 


V (er) 
l (er) 


To select input/output of program words as four 1l6—bit numbers enter: 


V (er) 
O (er) 


The four l6=bit integers represent bits 0-15, 16-31, 32-47 and 48-63 of 
a program word. 


Both examining and changing of program words are effected by V- 


The default for the V command is 0 for integer I/O of program words. 


e Examine command output formats. 


V=l1: (24 op code field values) 
V=0: (bits 0-15) (bits 16-31) (bits 32-47) (bits 48-63) 


e Change command input formats. 


V=l: C (cr) 
(desired op-code field to change) (cr) 
(new value) (cr) 


V=0: C (cr) 
(bits 0-15) (cr) 
(bits 16=31) (cr) 
(bits 32-47) (cer) 
(bits 48-63) (cr) 


The program word op=<code fields are listed in Section 3.4.6. When V=l, 
on examine, the 64<bits of a program word are divided into 24 fields, 
whose values are printed out. On change, the user enters the name of 
the field he wants to change along with the new value (hence the 
mnemonic V) for that field. The legal values for each field are listed 
in the AP Processor Handbook. 
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Examples: 


e Program location 20 contains the instruction 
LDSPI 14; DB=200 


which sets s-pad register 14 to 200. This example changes 
the instruction so that s=<pad 14 is set to 300 instead. 


E (cr) 
PS (cr) 
20 (cr) 
001660 000000 000000 000200 
* 

c (cr) 
1660 (cr) 
0 (cr) 
0 (cr) 
300 (cr) 
* 


Note that to change the value field (which is the fourth 
quarter) (bits 48-63) of the program word, all four quarters 
had to be entered. 


e Now change the instruction so that s-pad register 
ll (instead of 14) is loaded with 300. 


Ba 

V (cr) 
1 (cr) 
* 
C (cr) 
SPD (cr) 
ll (cr) 
x 


The SPD (s=pad destination) field (program word bits 10-13) 
was changed to ll. 
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e Examine program memory location 20 in both formats. 


os 
Q 
te} 
al 


000020 
1644 000000 000000 000300 


e - #I1OTrd ¢ 
[x - <j] oly: ta 


B 00 SOP 00 SH 00 SPS 16 SPD ll FADD 00 
Al__00 A2 00 __ COND 00 DISP 00 DPX 00 DPY 00 
DPBS 00 XR 00 YR __-00 XW 00 YW. 00 FM _00 
Ml _Ol M2 02 MI QO MA _00 DPA 00 TMA 00 


SPS=16 indicates the LDSPI instruction, SPD=ll indicates the 
s-pad destination register is ll. The YW, FM, Ml, M2, MA, 
DPA and TMA fields are meaningless since the value of 300 
occupied these fields. 


e Program location 30 contains the instruction. 


FADD FM, MD; FMUL TM, MD 


Change the second argument for the FADD (A2) from MD to FA. 


* 


E (er) 
PS (cr) 
30 (cr) 
000001 114000 000000 160000 
* 
V(er) 
1 (er) 
* 

C (er) 
A2 (cr) 
1 (er) 
* 
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3.3 MEMORY LOADING AND DUMPING 


Blocks of AP memory locations may be loaded and dumped to and from 
files with the following commands: 


Y yank (load) into a memory from a file 
W write out the contents of a memory to a file 
Z zero all the memories (and registers) (APSIM only) 


The list of memories on which the above commands can operate is 
different for APDBUG and for APSIM. In APSIM, only main data memory 
(MD), table memory (TM), and program source memory (PS) may be yanked 
into or written frome In APDBUG, the list of memories is extended to 
include s=pad (SP) and data pad X and Y (DPX, DPY). 


A further difference lies in the area of I/0 data formats. In APSIM, 
yanking and writing to/from 38-bit memories are always performed in the 
floating-point format (F=1). Program source memory I/0 is always in 
integer mode (V=0). In APDBUG, 1/0 to/from 38-bit memories is governed 
by the F command. Hence, it is either in floating-point or integer 
mode, as set by the user. Program source memory input is always in 
integer mode, whereas output can be in either integer or op-code field 
format, as governed by the current setting of the V command. 


The user should be aware that the procedure for entering filenames 
varies greatly according to the respective systems In some systems the 
motion of user files is nonexistent. In these cases, a logical unit 
number referring to an 1/0 device, which was opened previously by JCL 
control statements must be entered in place of a filename. Other 
systems allow access to disk files, line printers and terminals by 
Symbolic names. Thus, what must be entered for a filename depends on 
the convention of each respective system. The examples given in the 
following are only meant to be representative and may not be legal on a 
given system. 
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3.3.1 YANK FROM A FILE (Y) 


To load a memory from a file enter: 


Y (cr) 
(memory name) (cr) 
(starting location) (cr) 
(filename) (cr) 


(memory name) is an AP memory-e The beginning memory address is loaded 
at (starting location). The name of the file from which the data is to 
be read is called (filename). (filename) must, of course, be in the 
proper form as determined by the particular host operating system. 


Yank is used typically to load programs into program memory and data 
into main data memory. 


Examples: 


e Load a program into PS location 0. The program is assumed 
to be in a file named PROG] which was created using the E 
command output from APLINK. 


on 
Y (cr) 
PS (cr) 
0 (cr) 
PROG1 (cr) 
r 


e Load data into MD starting at location 20 from a file 
called DATA. Section 3.3.4 explains how to create data files. 


k 
Y (er) 
MD (cr) 
20 (cr) 
DATA (cr) 
fad (cr) 
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3.3.2 WRITE TO A FILE (W) 


To write the contents of a memory into a file enter: 


W (cr) 
(memory name) (cr) 
(starting location) (cr) 
(ending location) (cr) 
(filename) (cr) 


(memory name) is an AP memory, (starting location) is the initial 
address to be written, (ending address) is the last address to be 
written and (filename) is the name of the file into which the data is 
to be written. 


Examples: 


e Write main data memory locations 20 through 40 into a 
file called DUMP. 


* 
W (cr) 
MD (er) 
20 (cr) 
40 (cr) 
DUMP (cr) 
* 
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e Write data pad X, locations 3 through 6, to the line printer 
first, in floating-point format and second, in integer format. 
(In this example, the line printer is called LP:.) Note 
that a data pad may be dumped only from APDBUG. 


(cr) 
(cr) 


(cr) 
(cr) 
(cr) 
(cr) 
(cr) 


rd 
as) 


rd 


(cr) 
(cr) 


(cr) 
(cr) 
(cr) 
(cr) 
(cr) 


td 
rq 


EDO Ble ole Taw Sls er mile 


If the user mistypes a W command, he has several options to abort the 
command. If the wrong memory name or starting address was typed, the 
command may be canceled by entering an ending address (which is lower 
than the starting address). In APDBUG, an unwanted dump already 
underway (for example, when a location 1000 was ttyped whereas location 
100 was wanted) can be aborted by a USER BREAK. How this is 
accomplished varies from system to system. Typically, on single-user 
mini~computer systems, it is accomplished by raising the most 
significant bit of the host switch register. 
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3-3-3 ZERO THE AP (Z) 


The Z command is legal only in APSIM. It zeros out all the registers 
and memories in APSIM. It should be the first command given to APSIM. 
It is accomplished by entering: 


Z (er) 


3.3.4 PREPARING DATA FILES FOR YANKING 


Data files may be prepared by the user for loading into MD and TM by 
using APSIM (typically prepared by using the host system editor). The 
files may be prepared for loading into MD, SP, DPX, and DPY by using 
APDBUG. The format of the data file is as follows: 


data count 
data item #1 
data item #2 


data item #N 


All entries must be left justified, one entry per line. 


The data count is the number of memory locations to be filled and 
written as a real number (with a decimal point). Thus, if there were 
three data items, the count would be 3. 


The format of data items depends on which debugger is used- In APSIM, 
only floating point numbers may be loaded. These must appear one per 
line in the data file.- In APDBUG, the format is determined by the F 
command setting for 38-bit memories. For integer formats, the radix is 
determined by the N (radix) command. When floating point numbers are 
used they appear one per line. Also, integers must appear one per line 
in the file. Thus, for 38-bit memories written in integer format 
(F=0), three integers (exponent, high mantissa, low mantissa) written 
on three separate lines must be included for each memory location. 
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Examples: 


e A four element floating point data file is entered. 


e This example illustrates three element integer data for a 38=bit 
wide memory.e Three integers are loaded into the low 
mantissae (This applies to APDBUG only.) 


WOONDdDAOFYFOOW 
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3.3.5 EXECUTING PROGRAMS 


AP program execution may be controlled with the following commands: 


B set breakpoint 

D delete breakpoint 

L list breakpoint 

Q set breakpoint counter 

S set step mode 

I initialize the AP 

R run an AP program 

P proceed (continue) with an AP program 
T print elapsed execution time 

M set memory speed 


X exit to the host operating system 


The typical strategy when debugging a program is to set a breakpoint at 
a strategic location in the program. Run the programe When it stops 
at the breakpoint, examine various data locations to see what has been 
changed correctly or incorrectly. This strategy typically results in 
alternately running a program and examining the results. 
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3.3.5.1 Set Breakpoint (B) 


To set a breakpoint enter: 


B (cr) 
(memory name) (cr) 
(location) (cr) 


(memory name) is the memory on which to break execution (must 
be MD, TM or PS) and (location) is the memory address on which to 
stope The AP allows breakpointing on two conditions: 


e read or write of a given Main Data memory or 
Table memory location 


e execution of a given program instruction 


Contrary to typical debuggers, the program halts after 

executing the breakpointed instruction. Only one breakpoint can be 
set at a time. Setting a new breakpoint clears any previously set 
breakpoint. Users of APDBUG should consult of the 

AP Processor Handbook for possible interaction 

between the breakpoint and the program. 


Examples: 


e Set a breakpoint so that the program stops after 
executing the instruction at location 20. 


= 
B (cr) 
PS (er) 
20 (er) 
k 


e Set a breakpoint so that the program stops after 
reading or writing Main Data location 100. 


= 
B (cr) 
MD (cr) 
100 (er) 
* 


FPS 860-7292-002 3 = 26 


3.3.5.2 Delete Breakpoint (D) 


To delete a breakpoint enter: 
D (er) 


This command clears any previously set breakpoints. 


3-3-5-3 List Breakpoint (L) 


To list at the terminal which breakpoint is currently set enter: 


L (cr) 


APDBUG types the memory name in which the breakpoint is set, followed 
by the location of the breakpoint. If no breakpoint is set, only an 
asterisk (*) is typed. 


Example: 


e If a breakpoint is set at PS location 20, entering 
the L command results in the following: 


& 


L (er) 
PS 000020 
* 
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3.3.5.4 Set Breakpoint Counter (Q) 


To set the breakpoint counter enter: 


Q (cr) 


(count) (cr) 


(count) is the desired counter setting. The breakpoint counter is the 
number of times a breakpoint must be encountered before the AP program 
halts. It is also used by the step command. (Refer to Section 
3-3.5-5-) For example, it is useful when a bug occurs every ten times 
around a loop. The count is reset to one every time a new breakpoint 
is set or the step flag is set or reset. 


Example: 


e Set a breakpoint at location 20 so that the program 
program halts only after encountering the breakpoint 


10 times. 
Ea 
B (er) 
PS (er) 
20 (cr) 
bas 
Q (cr) 
10 (er) 
bah 
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3.3.5.5 Set/Reset Step Mode (S) 


To set step mode enter: 


S (cr) 
Ll (er) 


To clear step mode enter: 


S (er) 
0 (cr) 


In step mode, the program executes only a single instruction after 
being started and then halts. This is useful when sequencing 
step=by-step through a piece of code while watching for a data location 
to be destroyed or for the program to go awry- Step mode also uses the 
breakpoint counter which, in step mode, counts instructions to execute 
before stopping. 


Examples: 


e Set step mode so that when next started, the program 
executes one instruction and then stops. 


(cr) 
(cer) 


fem w]e 


e Set step mode so that when next started, the program 
executes 100 instructions and then stops. 


pa 
s (cr) 
1 (cr) 
x 
Q (cr) 
100 (er) 
x 
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3.3.5.6 Initialize the AP (TI) 
To initialize (reset) the AP enter: 


I (er) 


In APSIM, the initialize command clears the memory, timing and 
arithmetic pipelines- In APDBUG, an interface reset is done to the AP. 
This is necessary to stop a program which is trapped in an infinite 
loop. 


3-3-5-7 Run An AP Program (R) 


To run an AP program enter: 


R (cr) 
(location) (cr) 


(location) is the program location where execution starts. APDBUG 
Starts the program at the specified location and then waits until the 
program encounters a breakpoint. If the program loops uncontrollably 
in APSIM, the user typically has no recoursee In APDBUG, control can 
be regained by causing a USER BREAK. (See Section 3.3.2.) 


When the AP program finally halts, APSIM responds by printing out the 
current program address (PSA), the total elapsed program execution time 
after the last R command, and the contents of the currently open 
register or memory location. APDBUG merely responds with an asterisk 


(*). 


FPS 860-7292-002 3 = 30 


Examples: 


e Under APSIM, examine MA, set a breakpoint at program 
location 16, and then start program execution at location 10. 


E (cr) 
MA (cr) 
123 

rs 

B. (cr) 
PS (cr) 
16 (cr) 
* 

R (cr) 
10 (cr) 
PSA=000017 1.17 us. 
MA 

123 


"| 


The program has executed four 1.17 us and has stopped with 
location 17 as the next instruction to be executed. MA has 
not changed. Note that the listing of the last examined 
location is useful for monitoring registers to see when 
they change. 


@ Under APDBUG, set a breakpoint at program location 16, 
then start execution at location 10. 


= 
B (cr) 
PS’ (er) 
16 (er) 
* 
R (cr) 
10. (er) 
* 


APDBUG signals program return by outputting the '*. 
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3.3.5.8 Proceed With AP Program Execution (P) 


To proceed with AP program execution enter: 
P (cr) 


This command is used to resume AP program execution after encountering 
breakpoint or when using step mode. The program continues execution at 
the address currently in the Program Source Address register (PSA). 
When the program next encounters a breakpoint, output is the same as 
that which follows a return from a run. 


Examples: 


e Set a breakpoint at location 16, run at location 10, 
examine S-Pad 3, and then continue execution. 


* 
B (cr) 

PS (er) 

16 (er) 

* 

R (cr) 

10 (er) 

PSA=000007 1.17 us. 
* 

E (cr) 

SP (cr) 

3 (er) 

000123 

* 

P (er) 
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e Examine MA. Then watch it change as the program is 
Stepped starting at location 10. 


(cr) 
(cr) 


(cr) 

(cr) 

000103 

*& 

R (cr) 

10 (er) 

PSA=000011 0.17 us. 
MA 

000104 

& 

P (cr) 

PSA=000012 0.33 us. 
MA 

000105 

* 

P (er) 

PSA=000013 0.50 us. 
MA 


000106 
* 


Sl ot le 
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3.3.5.9 Execution Time (T) 


To print elapsed AP program execution time up to the last run (R) 
command (APSIM only) enter: 


T = (er) 


3-3-5210 Set Memory Speed (M) 


To set Main Data Memory speed (APSIM only) enter: 


M (cr) 
(speed) (cr) 


where (speed) is 1 for fast memory timing and 2 for standard memory 
timing. The default is 2 for standard memory timing. 


3-3-5-11 Exit To The Host System (X) 


To complete a debugging session and exit to the host operating system 
enter: 


X (cr) 
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3.4 SUMMARY OF APDBUG COMMANDS 


This section summarizes the APDBUG commands. 


3.4.1 ABBREVIATIONS 


Abbreviations used in the following appendixes: 


symbol meaning 

(cr) carriage return 

(loc) an integer location number 

(count ) an integer count 

(val) an integer value 

(fpn) a floating point number in form acceptable 
to FORTRAN 

(mem) the name of an AP internal memory 

(reg) the name of an AP internal register 


APDBUG outputs an asterisk (*) when ready for further action. 
question mark (?) is output when a command is not understood. 
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34.2 PROGRAM EXECUTION COMMANDS 


B (cr) Breakpoint. Delete the last breakpoint 

(mem) (cr) and set a new breakpoint at location (loc) 
(loc) (cr) of memory (mem). (mem) must be PS, MD, or TM. 
D (cr) Delete. Delete the current breakpoint. 

L (cr) List. List the current breakpoint. 

Q (cr) Set the continue counter to (count). 


(count) (cr) 


S (cr) Stepe If (val) is not zero, place the 
(val) (cr) AP in step mode. 
ak (cr) Initializee Reset the AP 


before program execution is resumed next. 


R (cr) Rune Begin program execution at 
(loc) (cr) Program Source location (loc). 
P (cr) Proceed. Begin instruction execution 


at the Program Source location pointed to by 
the AP PSA (Program Source Address) 


register. 
T (cr) Print out elapsed execution time (APSIM only). 
x (cr) Exit to the operating system. 
M (cr) Set memory speed.- val is 1 for one cycle 


(fast) memory and 2 for the two cycle 
(val) (cr) (standard) memory (APSIM only). 
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3.4.3 REGISTER EXAMINATION /MODIFICATION COMMANDS 


(val) 


(val) 


(cr) 


(er) 


(cr) 
(cr) 


(cr) 


(cr) 
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Examine register. Print out the contents of 
AP register (reg). 


Examine memory- Print out the contents of 
AP memory (mem), location (loc). 


Re~examine the currently open register or 
memory location (the last location examined). 


Examine the next higher sequential memory location 


of the memory that is currently open. 


Examine the next lower sequential memory location 


of the memory that is currently open. 


Floating point flag, affects the input/output of 
38-bit wide registers and memory locations. 
(val)=0: 3 integers (exponent, high mantissa, low 
mantissa): (val)=l: floating point. 


Program source field value flag, affects 
input/output of program source memory location. 
(val)=0: 4 integers (the four l6<bit quarters of 
PS) 

(val)=1: Decode into the 24 instruction word 
field values. . 


C (cr) Change. Change the contents of the currently open 

(val) (cr) register or memory location to (val). The format 
of (val) depends on the width of the current open 
locations as follows: 


l6=bit wide registers: an integer of the current 
radix. 


38-bit wide registers: 
F=0; (val) (cr) three integers in the current 
(val) (cr) radix which represent — 
(val) (cr) the exponent, high mantissa, 
and low mantissa 


F=1; (fpn) (cr) a floating point number legal 
to FORTRAN 


64-bit wide registers: 

V=0: (val) (cr) four integers in the current 
(val) (cr) radix which are the four 
(val) (cr) quarters of an AP program word 
(val) (cr) 


V=1: (field)(cr) (field) is the name of the 
instruction field to be changes 
(val) (cr) (val) is the new integer value 


N (cr) Number radix. Set the radix for integer user 
(val) (cr) I/O to (val), which must be 8 (for octal), 10 (for 
decimal), or 16 (for hexadecimal). 


0 (cr) Offset. Sets the base address to which program 
(val) (er) source memory addresses are relative 
(for user 1/0). 


Z (cr) Zero. Zero out all AP memories and registers. 
(APSIM only) 
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324.4 MEMORY LOAD/DUMP COMMANDS 


4 (cr) Yank: Load memory starting at (loc). 
(memory) (cr) from an external file. 
(loc) (cr) 


(filename) (cr) 


W (cr) Write: Dump memory starting at location 

(mem) (cr) (start) and ending at location (stop) to 
(start) (cr) external data (filename). 

(stop) (cr) (mem) can be PS, MD or TM. 


(filename) (cr) 
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3.4.5 


ACCESSIBLE FUNCTIONAL UNITS 


This section lists the AP functional units that can be examined or 
changed with APDBUG. 


3-4-5-1 Memories 


Mnemonic 


PS 


Name 


Program Source memory 

Main Data memory 

Table Memory 

Data Pad xX 

Data Pad Y 

I/O devices 

S-Pad 

Subroutine Return 
Stack 
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Accessible from Can ’Y’or’W’ 


Width APSIM APDBUG APSIM APDBUG 
64 yes yes yes yes 
38 yes yes yes yes 
38 yes (read only) yes yes 
38 yes yes no yes 
38 yes yes no yes 
33 yes no no no 
16 yes yes no no 
16 yes no no no 

ed 
readable readable 
and and 
writeable writeable 
from from files 
terminal using "Y" 
and "w" 
- 40 


324.522 


Mnemonic 


CTL 
FMTH 
FMTL 
IFRS 
IFSTAT 


Registers 


Name 


Main Data Address 
Table Memory Address 


,Data Pad Address 


Program Source Address 
S-Pad Destination Addr. 
AP Status Register 

I/O Device Address 
S-Pad Function 


Switch register 
Function register 
Lites register 

AP DMA Memory Address 
Host DMA Memory Address 
DMA Word Count 

DMA Control register 
Formatter high 
Formatter low 
Interface reset 
Interface status 


Main Data Read Buffer 
Table Memory Read Buff. 
Main Data Input Buff. 
Data Pad Bus 

I/O Input Bus 

Panel Bus 

Program flags 
Subroutine Stack Addr. 
Floating Adder #1 input 
Floating Adder #2 input 
Multiplier #1 input 
Multiplier #2 input 
Floating Adder output 


Floating Multiplier out. 
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38 
38 


Accessible from: 


' APSIM 


yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 


no 
no 
no 
no 
no 
no 
no 
no 
no 
no 
no 


yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 


APD BUG 


yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 


yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 
yes 


yes (when 


no 
no 
no 
no 
no 
no 
no 
no 
no 
no 
no 
no 
no 
no 


present) 


3.4.6 PROGRAM WORD FIELDS 


The following are fields within an instruction word that may be 
examined or changed by name. 


Name Program Word Bits 
D 0 

SOP 1-3 
SH 4e5 
SPS 6<9 
SPD 10-13 
FADD 14-16 
Al 17-19 
A2 20=22 
COND 23=26 
DISP 27-31 
DPX 32=33 
DPY 34=35 
DPBS 36-38 
XR 39-41 
YR 42-44 
XW 45=47 
YW 48-50 
FM 51 

Ml 52=53 
M2 54-55 
MI 56-57 
MA 58=59 
DPA 60-61 
TMA 62-63 
SOP1 6-9 
SPEC 6-9 
STST 10-13 
HPNL 10-13 
SPSA 10-13 
PSEV 10-13 
PSOD 10-13 
PS 10-13 
SEXT 10-13 
FAD1L 17-19 
IO 17-19 
LREG © 20=22 
RREG 20—22 
TOUT 20-22 
SNSE 20=22 
FLAG 20-22 
CONT 20-22 
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3.5 AN EXAMPLE DEBUGGING SESSION 


In this example an AP program called PROG] is being debugged. PROGL 
uses the FPS supplied divide routine to divide two numbers in Main Data 
memory. 


3-5-1 APAL SOURCE PROGRAM 


STITLE PROG] 
SENTRY PROG1, 3 
SEXT DIV 


"PROGI] DOES A SCALAR DIVIDE OF TWO NUMBERS IN MAIN DATA 
"MEMORY AND RETURNS THE ANSWER BACK INTO MAIN DATA MEMORY 
"C <= A / B 


"S-PAD PARAMETER DEFINITIONS: 
' 


t 


A SEQU 0 “ADDRESS OF “A” IN MAIN DATA MEMORY 
B SEQU 1 "ADDRESS OF ’B”’ IN MAIN DATA MEMORY 
C SEQU 2 "ADDRESS OF °C’ IN MAIN DATA MEMORY 


Lh) 


PROG1: MOV A,A; SETMA "FETCH A 
MOV B,B; SETMA "FETCH B 


NOP "WAIT 

DPY <MD "SAVE A IN DPY 

DPX<MD 5 "SAVE B IN DPX 
JSR DIV "AND DIVIDE A/B 


MOV C,C; SETMA; “STORE ANSWER IN C 
MI<DPY; RETURN "AND RETURN 
SEND 


The input parameters are the addresses of scalars A, B, and Ce. A and B 
are fetched from Main Data memory, A is divided by B, and the result 
stored into C. The SENTRY declaration tells APAL that the routine’s 
name is PROG]. The ",3" tells APAL that the routine is FORTRAN 
callable through APEX and has three S-Pad parameters (the addresses of 
A, B, and C)- The SEXT tells APAL that the routine uses the DIV 
routine. 
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3.5.2 ASSEMBLING THE PROGRAM USING APAL 


RUN APAL (cr) 

SOURCE FILE= 

PROG1.AP (cr) 

OBJECT FILE= 

PROG1.OBJ (cr) 

LISTING AND ERROR FILE= 
PROG1.LST (cr) 


LISTING? 1=YES, O=NO: 
1 (cr) 
LISTING RADIX: 1=HEX, O=OCTAL: 
0 (cr) 
OQ ERRORS: PROG] APAL=REV 2 


File PROG1.AP is assembled with the object code placed on file 
PROG1.OBJ, and the listing (reproduced below) placed on file PROGI.LST. 


APAL, REV 2 

PASS 1 

PASS 2 
STITLE PROGL 
SENTRY PROG1,3 
SEXT DIV 


"PROGL DOES A SCALAR DIVIDE OF TWO NUMBERS IN MAIN DATA 
"MEMORY AND RETURNS THE ANSWER BACK INTO MAIN DATA MEMORY 
"C <=A / B 

tw 


"S=-PAD PARAMETER DEFINITIONS: 


t 


’ IN MAIN DATA MEMORY 


000000 A SEQU 0 "ADDRESS OF “A 

000001 B SEQU 1 "ADDRESS OF °B’ IN MAIN DATA MEMORY 
000002 C SEQU 2 "ADDRESS OF °C’ IN MAIN DATA MEMORY 
000000 A SEQU 0 "ADDRESS OF °A’ IN MAIN DATA MEMORY 
000001 B SEQU 1 "ADDRESS OF “B’ IN MAIN DATA MEMORY 
000002 C SEQU 2 "ADDRESS OF ’C’ IN MAIN DATA MEMORY 


000000 040000 PROGL: MOV A,A; SETMA "FETCH A 
000000 
000000 
000060 


000001 040104 MOV B,B; SETMA “FETCH B 
000000 
000000 
000060 


000002 000000 NOP "WAIT 
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000003 


000004 


000005 


kk kk 


PROG1 
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000000 
000000 
000000 


000000 
000000 
015000 
100000 


011014 
000000 
045004 
177777 


040210 
000340 
004040 
000360 


0 ERRORS 


VALUE 


000004 EXT 


000000 
000001 
000002 


000000 ENT 


DPY <MD "SAVE A IN DPY 


"SAVE B IN DPX 
AND DIVIDE A/B 


DPX<MD 5 
JSR DIV " 


MOV C,C; SETMA; “STORE ANSWER IN C 
MI<DPY; RETURN "AND RETURN 


SEND 


kK 


3.5.3 LINKING THE PROGRAM USING APLINK 


RUN APLINK (cr) 

APLINK 

REV _2 

* L (cr) PROGL1.OBJ (cr) 
* L (cr) APLIB (cr) 
LOAD COMPLETE 

“5S. (cr) TTY (cr) 


HIGH=000041 


SYMBOL TABLE 


SYMBOL VALUE 

PROG1 000000 

DIV 000006 

* E (cr) PROGI.ABS (cr) 

PROG] HIGH=000041 

* X (cr) 

First PROG1.OBJ is loaded. Then the FPS supplied object library 
(called APLIB) is loaded ine APLINK picks out DIV from the library. 
When the loading is done, a symbol table (load map) is printed at the 
terminal. It shows that PROG] is loaded at location 0, and DIV at 
location 7. The high location loaded was 41 (octal), which means that 
the total size of the load module is 34 (decimal) program words. The E 


command is used to output the load module for APSIM (or APDBUG). It is 
placed on file PROG1.OBJ. 
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3.5.4 DEBUGGING THE PROGRAM USING APSIM 


RUN APSIM (cr) 


APSIM 
REV 2.0 
ad 

Z (cr) 
el 

b4 (cr) 
PS (cr) 
0 (cr) 


PROG1.ABS (cr) 
* 


Zero the simulator and yank in the load module. 


E (cr) 

SP (cr) 

0 (cr) 
000000 4, 
—— : 

C (er) 

2 (cr) 
=: 

+ (cr) 

SP 000001 
000000 
* 

C (cr) 

3 (cr) 
te 

+ (cr) 
SP 000002 
000000 
* 

C (cr) 

4 (cr) 


& 
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Set up S=Pads 0, 1, and 2 with the addresses of A, B, and Ce These are 
chosen here to be 2, 3, and 4, respectively. 


E (cr) 
MD (cr) 
z (cr) - 
0.0000000000 
ke 
c (er) 
10.0 (cr) 
k 
+ (cr) 
MD 000003 
0.0000000000 
* 
C (er) 
2.0 (cr) 
x 


Set A (in MD 2) to 10.0, and B (in MD 3) to 2.0. The result should be 
5s QO. 


E (cr) 

PS (cr) 

5 (cr) 
040210 000340 004040 000360 
* 

B_ (cr) 

PS (cr) 

6 (cr) 
& 


Examine PS location 5. It appears to be the last instruction of PROG], 
so set the breakpoint there. 


R (er) 

0 (cr) 
PSA=000000 5.00 US. 
PS 000005 


040210 000340 004040 000360 
*k 


Run the programe It took 5.0 us to reach the breakpoint. PSA is set 
to 0 since the program stopped on a RETURN, which returns to location 0 
Since the Subroutine Return Stack was zeroed by the Z command. PS 
location 5 is listed because it is the last location examined. 


E (cr) 
MD (cr) 
4 (cr) 
20.00000000 
* 
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However, the answer is wrong-e 10-0, not 20.0 should be the value 
of C (MD location 4). 


E (cr) 

DPY (cr) 

0 (cr) 
20.00000000 


| * 


DPY (where it appeared that DIV returned the answer) also contains 
20.0, not 10.0. Now examine DPX, since this might be the data pad in 
which DIV returns the answer. 


E (cr) 
DPX (cr) 
0 (er) 
5000000000 
x 


Yes, the answer is in DPX instead of DPY. A quick check of the AP Math 
Library Manual confirms that DIV returns the result in DPX, and that. 
DPY is used as a scratch location.e Now correct the program so that in 
PS location 5, MI<DPX appears instead of MI<DPY. 


E (cr) 

PS’ (cr) 

5 (cr) 
040210 000340 004040 000360 
x 

V (er) 

1 (cr) 


® 

PS 000005 
D 00 SOP 04 SH. QO SPS  Q2 SPD Q2 FADD 00 
Al 00 A200 COND 07 DISP 00 DPX 00 DPY 00 
DPBS 04 XR 00 YR. 04 XW QO YW 00 FM _0O 
Ml 00 M2 00 MI _Q3 MA 03 DPA 00 TMA 00 


= 

C (cr) 
DPBS (cr) 
3 (cr) 


* 
C (cr) 
XR (cr) 
4 (er) 
* 


PS 000005 
D 00 SOP 04 SH 00 SPS 02 SPD 02 FADD 00 
Al 00 A2__00 COND 07 DISP 00 DPX 00 DPY 00 
DPBS 03 XR 04 YR 04 XW 00 YW 00 FM _00 
Ml 00 M2. QO MI 03 MA _Q3 DPA 00 TMA 00 


| + 
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Examine PS location 5 and switch the PS output mode (V) to 1 for PS 
opcode field modee It shows that now the MI field (memory input) is 
set to 3 for data pad bus, and that the DPBS field is set to 4 for DPY. 
Change the DPBS field to 3 for DPX, and the DPX read address (XR) to 4, 
which biased by 4 gives the proper DPX address of 0. Determine that 
the proper corrections were made, reinitialize APSIM, and run again. 


I (cr) 
# 
R (cr) 
0 (cr) 
PSA=000000 5.00 US. 
PS 000005 
D 00 SOP 04 SH 00 SPS 02 SPD 02 FADD 00 
Al 00 A2 00 COND 07 DISP 00 DPX OO DPY 00 
DPBS 03 XR 04 YR 04 XW 00 YW 00 FM 00 
Ml 00 M2 00° ‘MI 03 MA 03 DPA 00 TMA 00 


* 

E (cr) 

MD (cr) 

4 (cr) 
52000000000 


2.000000000 


Cc. (cr) 
-3.4 (cr) 


* 
- (er) 
MD 000002 
10.00000000 
5 


C (er) 
12.5 (cr) 
* 
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Now try a different case where B = -3.4, and A = 12.5. The expected 
answer is approximately -3. 68. 


I (cr) 
* 

R (er) 

0 (er) 
PSA=000000 5.00 US. 
MD 000002 

12.50000000 
# 

E (cr) 

MD (cr) 

4 (cr) 

~3.676470578 
# 


Reinitialize and rerun, to make sure the correct answer is obtained. 
X (er) 


Now exit APSIM, edit the change into the source, and reassemble, link, 
and simulate to make sure the program is correct. 
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